Phone Number Freelanceer

The Phone Number Freelanceer service is part of the RISK API and allows you to obtain the phone number of a professional using the tax code parameter.

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

REQUEST EXAMPLE

POST/telefoni

The method to use in the request is POST:

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

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

This is an example of the parameters needed for a request with tax code DRSCLD70P15H501V:

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

The response is asynchronous. You can also set up a callback during the request to be notified when the data is available, without having to repeatedly call the GET /richiesta/{id} endpoint to check its status.

RESPONSE EXAMPLE

POST /telefoni

Here is an example of a pending response (i.e., waiting for the result), where you can obtain the request ID to use in a subsequent 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 obtain the data, it will be necessary to make a second request, as previously mentioned, to another endpoint with the ID previously obtained.

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

RESPONSE EXAMPLE

GET /IT-request/{id}

In the response, it will be possible to access the phone number, whether it is a 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",
      "type": [
        "phones"
      ],
      "callback": null,
      "result": {
        "code": 200,
        "info": "OK"
      },
      
      "timestamp": 1625232029,
      "owner": "companies@openapi.it",
      "subject": {
        "code": "RSSMRA90D15L117D"
        "numbers": ["3331234567"]
          ]
        },        
    "success": true,
    "message": "",
    "error": null
  }
  

The Phone Number Freelanceer Service is also available for searches on Private Individuals and Companies.

TERMS AND CONDITIONS OF SERVICE USE

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

By its nature, the service may also result in a null response (e.g., no data in public or publicly accessible databases), and the service incurs a cost even in this case. At the time of the request, the customer declares that they have a relevant right (e.g., debt recovery); in the case of a false statement, it is noted that the request is reported quarterly to the Prefecture offices with the corresponding consequences of false statements.

The service, although available in automatic mode via API, is subject to continuous monitoring of LOGs due to regulatory requirements, with the following limitations:

Requests made outside of these hours or on non-working days are queued and processed on a priority basis on the first working day.

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

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