Phone Number Person

The Phone Number Person service belongs to the API Risk and makes it possible, from the tax code parameter alone, to obtain the telephone number of a private individual, in full compliance with current privacy regulations.

Since this is sensitive information, it can only be requested by those with a legally relevant right.

REQUEST EXAMPLE

POST/telefoni

The method to be used in the request is POST:

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

The parameters to pass in the body of the request are:

This is an example of the parameters required for a request with tax code RSSMRA90D15L117D:

{
      "cf_piva": "RSSMRA90D15L117D",  
      "callback": {
        "url": "https://yourdomain.com/your_script",
        "field": "data",
        "method": "POST",
        "headers": {
          "session_id": "oiwejdf89453urf945jfg"
        }
      }
    }
    

The response is asynchronous. It is possible to set, during the request phase, a callback to be notified when the data becomes available, without having to call the GET/request/{id} endpoint multiple times to check its status.

RESPONSE EXAMPLE

POST/telefoni

Below is an example of a response in pending status (i.e., awaiting the result), where you can obtain the request id to use in a second call to access the desired data.

{
        "data": {
          "id": "60e866b6b3178c6dc80adf8e",
          "cf_piva": "RSSMRA90D15L117D",
          "tipo": [
            "telefoni"
          ],
          "callback": false,
          "url" false,
          "field" data,
          "method" POST,
          "data": false,
          "headers": {
            "session_id": ""oiwejdf89453urf945jfg""
          }
          "esito": "null"
          "timestamp": "null"
          "owner": "test@openapi.com"
          "soggetto": "null"
          "status": "PENDING",
          "date_request": "null",
          "date_completion": "null",
          },
        "success": true,
        "message": "",
        "error": null
      }

REQUEST EXAMPLE

GET /IT-request/{id}

To retrieve the data, a second request will be necessary, as previously mentioned, to another endpoint using the ID obtained earlier.

GET https://risk.openapi.com/IT-richiesta/60e866b6b3178c6dc80adf8e 

RESPONSE EXAMPLE

GET /IT-request/{id}

In the response, it will be possible to obtain the phone number, either landline or mobile, depending on availability.

{
        "data": {
          "status": "COMPLETED",
          "date_request": "2023-07-09 17:09:42",
          "date_completion": "2023-07-09 17:40:57",
          "id": "60e866b6b3178c6dc80adf8e",
          "cf_piva": "RSSMRA90D15L117D",
          "tipo": [
            "telefoni"
          ],
          "callback": null,
          "esito": {
            "codice": 200,
            "info": "OK"
          },
          
          "timestamp": 1625232029,
          "owner": "imprese@openapi.it",
          "soggetto": {
            "code": "RSSMRA90D15L117D"
            "utenze": ["3331234567"]
              ]
            },        
        "success": true,
        "message": "",
        "error": null
      }
      

The Phone Persona Risk service is also available for searches on Freelancers and Companies.

USAGE MODALITIES AND CONDITIONS OF THE SERVICE

Please note that this service can only be requested if there is a legally relevant right (any subjective position that establishes a relationship between the interest and the documentation requested).

By its nature, the service may also provide a null response (e.g., no data in public or publicly accessible databases), and in such cases, the service still incurs a cost. At the time of the request, the client declares to have a relevant right (e.g., debt recovery). In the case of false declarations, please note that requests are reported quarterly to the Prefecture offices, with the related consequences of false declarations.

Although the service is available automatically via API, it is subject to continuous LOG monitoring due to regulatory requirements, with the following limitations:

Requests made outside these hours or days will be queued and processed on a priority basis on the next business day.

The service, as per contractual conditions, has daily rate limit constraints set for proper service management.

If you wish to have a customized service, contact us here.

The service is already used by debt collection companies, lawyers, banks and law firms, which have a legitimate interest in contacting natural or legal persons regarding outstanding financial obligations, or in order to serve legal documents.