Skip to main content

Validation Services

Tax Code Calculation

Calculate an Italian tax code (Codice Fiscale) from surname, name, gender, date of birth, and city of birth, with a quality flag for the result.

Endpoint​

POSThttps://{host}:{port}/Egon/api/norm

Headers & authentication​

Required request headers and their expected values.

FieldTypeDescription
tokenreq
String

Authentication token sent in the token request header.

Request​

Country context, `taxfnx` function `3`, and personal identity data.

FieldTypeDescription
parreq
Object

Country context and tax-code calculation function.

iso2
String

Country code, ISO 3166-1 alpha-2.

One of iso2 or iso3 is required.

iso3
String

Country code, ISO 3166-1 alpha-3.

One of iso2 or iso3 is required.

taxfnxreq
String

Tax-code configuration function.

  • 3 Calculate tax code from identity data

Default value: 3

datareq
Object

Input data to validate

namereq
Object

Identity and demographic data used to calculate tax code

full_namereq
String

Surname

first_namereq
String

First name

genderreq
String

Gender (1 Male, 2 Female)

birth_datereq
String

Date of birth in YYYYMMDD format

birth_placereq
String

Birth city description

Response​

Calculated tax code, quality indicators for personal identity fields, and system status.

FieldTypeDescription
data
Object

Normalized and enriched validation output data

tax_code
Object

Calculated Italian tax code details

cod_description
String

Calculated Italian tax code

quality
Object

Validation quality indicators and score flags

tax_code
Object

Quality indicator result (see https://documentation.egon.com/docs/quality-indicators)

flag
String

Quality flag

code
Number

Quality result code

description
String

Quality result description

name
Object

Quality indicators for personal name parsing and demographic verification

person
Object

Quality indicator result (see https://documentation.egon.com/docs/quality-indicators)

birth_date
Object

Quality indicator result (see https://documentation.egon.com/docs/quality-indicators)

birth_place
Object

Quality indicator result (see https://documentation.egon.com/docs/quality-indicators)

system
Object

Request processing status.

ret_code
Number

Processing result code. 0 means no blocking error.

des_ret_code
String

Human-readable processing result.

On this page
Request Example
curl -X POST "https://{host}:{port}/Egon/api/norm" \
  -H "token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "par": {
    "iso3": "ITA",
    "taxfnx": "3"
  },
  "data": {
    "name": {
      "full_name": "Rossi",
      "first_name": "Mario",
      "gender": "1",
      "birth_date": "19930219",
      "birth_place": "Verona"
    }
  }
}'
Last updated on