Phone Number Company

The Company Phone service belongs to the RISK API and allows you to obtain the phone number of a company from the tax code.

The service is identified by the endpoint https://risk.openapi.com/IT-telefoni.

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 12485671007:

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

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

RESPONSE EXAMPLE

POST/telefoni

Below is an example of a response in pending status (i.e., waiting for the result) where it will be possible to obtain the request ID to use in a second call to access the desired data.

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

REQUEST EXAMPLE

GET /IT-richiesta/{id}

To obtain the data, a second request to another endpoint with the previously obtained ID will be necessary, as mentioned.

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

RESPONSE EXAMPLE

GET /IT-richiesta/{id}

The response will include the phone number, whether fixed 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": "12485671007",
      "tipo": [
        "061234567"
      ],
      "callback": null,
      "esito": {
        "codice": 200,
        "info": "OK"
      },
      "timestamp": 1625232029,
      "owner": "[email protected]",
      "soggetto": {
        "code": "12485671007",
        "utenze": ["3331234567"]
      },
    "success": true,,
    "message": "",,
    "error": null
  }
  

The Company Phone service is also available for searches on Individuals and Freelancers.

USAGE MODALITIES AND CONDITIONS

Please note that this service can only be requested based on a legally relevant right (any subjective position that defines an instrumental relationship between this interest and the documentation requested).

Due to its nature, the service may also return a null response (e.g., no data in public or publicly accessible databases). Even in this case, a fee is incurred. The client, at the time of request, declares having a relevant right (e.g., debt recovery). In case of false declarations, it is noted that requests are reported quarterly to the Prefecture offices with the related consequences for false statements.

Although the service is available in automatic mode via API, it is subject to continuous monitoring of the LOGs due to regulatory reasons with the following limitations:

Requests made at other times or on other days are queued and processed on a priority basis on the first working day.

As per contractual conditions, the service has daily rate limit constraints set for proper service management.

If you want a customized service, contact us here.