Company Real Time Risk

  • Openapi Delivery : 2 Hours
  • Openapi starting from € 0,70 + vat

Get the name, registered office, ATECO code e description, telephone and negative events of a company in seconds.

All information for identifying an Company available via API.

Esempio Company Real Time Risk

The Company Real Time Risk  service belongs to the RISK API and makes it possible to obtain, from the tax code parameter, a series of useful information for verifying the existence and identification of a company.

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

The Risk Company service allows you to obtain company name, registered office, ATECO code e descriptionnegativity, and phone with a single request.

EXAMPLE REQUEST POST /richiesta

The method to be used in the request is POST:

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


The parameters to be passed in the body of the call are:

  • tax code
  • callback (optional)

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

{
  "cf_piva": "12485671007",  
  "tipo": [
    "anagrafica",  "negativita","telefoni"
    ]
  "callback": {
    "url": "https://yourdomain.com/your_script",
    "method": "POST",
    "field": "data",    
    "headers": {
      "session_id": "oiwejdf89453urf945jfg"
    }
  }
}


It is also possible to request only a subset of the information. In this case, you can indicate in the type field the desired dataset (company profile, negative information, or phone numbers) or use the specific endpoints for each dataset directly during the request.

The response is asynchronous. It is possible to set a callback during the request to be updated when the data is available, without having to call the GET /request/{id} endpoint multiple times to check its status. If the callback is set, 'headers' is a mandatory field and can be used to declare all the headers the user wants to be returned in the callback (such as session_id).

EXAMPLE RESPONSE POST /request

The response will include the request ID, which can be used in a second call to obtain the desired data:

{
    "data": {
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "12485671007",
      "tipo": [
        "anagrafica",  
        "negativita",
        "telefoni"
      ],
      "callback": true,
      "url" https://yourdomain.com/your_script,
      "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
  }


EXAMPLE RESPONSE GET /IT-request/{id}

The response will provide access to the following information:

  • Company name
  • VAT number
  • Registered office address
  • Tax domicile address
  • ATECO code and description
  • Phone number (landline or mobile)
  • Presence of negative events (protests, prejudicial acts, insolvency procedures)
{
    "data": {
      "status": "COMPLETED",
      "date_request": "2024-03-09 17:09:42",
      "date_completion": "2024-03-09 17:40:57",
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "12485671007",
      "tipo": [
        "anagrafica",
        "negativita",
        "telefoni"
      ],
      "callback": null,
      "esito": {
        "codice": 200,
        "info": "OK"
      },
      
      "timestamp": 1717141431,
      "owner": "[email protected]",
      "soggetto": {
        "code": "12485671007",
        "risultato": "OK",
        "nome": null,
        "cognome": null,
        "deceduto": false,
        "decesso_data": null,
        "nascita_luogo": null,
        "nascita_data": null,
        "sesso": null,
        "residenza": null,
        "domicilio_fiscale":{
          "indirizzo": "VIALE F TOMMASO MARINETTI 221",
          "toponimo": "VIALE",
          "via": "F TOMMASO MARINETTI",
          "numero_civico": "221",
          "comune": "ROMA",
          "cap": "00143",
          "provincia": "RM"
        },
        "denominazione": OPENAPI SPA,
        "partita_iva": 12485671007,
        "ateco_codice": 620100,
        "ateco_descrizione": "Produzione di software non connesso all'edizione",
        "sede_legale": {
          "indirizzo": "VIALE F TOMMASO MARINETTI 221",
          "toponimo": "VIALE",
          "via": "F TOMMASO MARINETTI",
          "numero_civico": "221",
          "comune": "ROMA",
          "cap": "00143",
          "provincia": "RM"
        },
        "utenze":[
          "061234567",
          "061234568",
          "333123456"
        ],
        "negativita": {
          false,
          false,
          false
        }
      }
    },
    "success": true,
    "message": "",
    "error": null
  }
  


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

CONDITIONS AND TERMS OF SERVICE USAGE

The service, although available in automatic mode via API, is subject to continuous LOG monitoring for regulatory reasons with the following limitations:

  • the service is active from 9 AM to 7 PM
  • the service is active only on weekdays
  • the rate limit is automatically configured for each customer based on the annual volumes purchased

Requests made outside these hours or days are queued and processed on a priority basis on the next working day.

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

Our prices

Price list for single API calls

  • Company Real Time Risk € 2,20 + vat
  • Company Data Risk € 0,80 + vat
  • Company telephone numbers report € 0,70 + vat
  • Company Negative events € 0,70 + vat