Tax Code Check for a Person - Italy

The Tax Code Verification service allows you to verify the validity of an individual’s tax code and is currently available only for Italy.

The tax code is the tool that uniquely identifies Italian citizens and is essential for registering and monitoring individuals and their transactions with public and private entities. Issued by the Agenzia delle Entrate (the Italian Revenue Agency), the code is similar to the Social Security number used in other countries.

The Tax Code Verification API is available in two modes:

The tax code consists of 16 alphanumeric characters:

Verifying the tax code is essential to ensure that it actually corresponds to an existing person registered in the Italian tax system. This tool helps prevent fraud and abuse, ensuring that the code is valid and belongs to the indicated individual.

Unlike other APIs, the Openapi service does not simply check the formal correctness of the entered tax code, but also verifies that it is actually registered with the Agenzia delle Entrate.

By integrating this API service, it will be possible to verify the identity of customers and suppliers, ensuring that business transactions take place with legitimate and registered entities.

ASYNCHRONOUS MODE

The asynchronous mode represents the most powerful, scalable, and efficient solution for integrating the Tax Code Verification service. It is designed to handle massive requests, automated workflows, and high-volume enterprise architectures.

Thanks to the new technologies implemented, the asynchronous endpoint allows a 10% cost saving and is available with no Rate Limit (Zero Rate Limit), ensuring maximum operational continuity even during traffic peaks.

With this mode, the request is immediately taken into charge and a unique identifier (request ID) is returned. Processing takes place in the background and the result can be retrieved later through the dedicated endpoint.

It is also possible to configure a webhook (callback) to automatically receive updates on the request status. The callback does not return the verification result, but only notifies status changes. When the status becomes processed, it will be necessary to call the result retrieval endpoint to obtain the final outcome.

REQUEST EXAMPLE

POST /IT-verifica_cf

In the request body, it is necessary to provide the tax code to be verified. It is also possible to specify a webhook (callback) URL to receive status updates.

POST https://risk.openapi.com/IT-verifica_cf

{
  "codice_fiscale": "RSSMRA85M01H501Z",
  "callback": "https://tuodominio.it/webhook"
}

INITIAL RESPONSE EXAMPLE

When the request is created, the system immediately returns an ID and the processing status.

{
  "id": "abc123",
  "stato": "in_attesa",
  "codice_fiscale": "RSSMRA85M01H501Z",
  "validita": null
}

The status can take two values:

RESULT RETRIEVAL

The result can be retrieved by querying the endpoint with the ID received when the request was created.

GET /IT-verifica_cf/{id}

{
  "id": "abc123",
  "stato": "evaso",
  "codice_fiscale": "RSSMRA85M01H501Z",
  "validita": true
}

SYNCHRONOUS MODE

With this mode, tax code verification takes place in real time and the result is returned immediately within the same API call.

If the system is unable to process the request immediately, it will no longer return an error but instead a 201 status with a unique ID. The result can then be retrieved later through the dedicated endpoint.

REQUEST EXAMPLE

GET /IT-verifica_cf/{codice_fiscale}

The parameter to be used is the tax code to be verified; the request must be made using the GET method.

GET https://risk.openapi.com/IT-verifica_cf/xxxxxxxxxxxxxx

RESPONSE EXAMPLE

If the request is processed immediately, the response will indicate whether the verified tax code is valid (true) or not valid (false).

{
  "data": { 
   "validita": true
  }, 
  "success": true,
  "message": "Request completed",
  "error": null
}

Tax Code Verification is already used by companies, professionals, and public entities that need to verify the identity of customers and suppliers to ensure that transactions take place with registered and legitimate parties, preventing fraud and abuse.