HomeProductsCheck Risk for Freelancers (All)

Check Risk for Freelancers (All)

€0.70 + VAT

Obtain the name, residence, registered office, code and ATECO description, phone number, and negative events of a freelancer using only the VAT number.

Delivery

In 2 hours

API

Risk

available for
  • it

The Check Risk for Freelancers (All) service belongs to the RISK API and allows you to obtain, from the parameter tax code, a series of useful information for identifying residence, fiscal domicile, and telephone number, as well as verifying any negative events related to a freelancer.

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

Check Risk for Freelancers (All) allows you to retrieve in a single request the name, registered office, ATECO code and description, negative events, and phone number.

REQUEST EXAMPLE

POST/request

The method to be used in the request is POST:

POSThttps://risk.openapi.com/IT-request

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

  • tax code
  • callback (optional)

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

{
  "cf_piva": "RSSCLD79R07H501O",  
  "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 part of the information. In this case, you can indicate the desired dataset (anagrafica, negativita, or telefoni) in the "tipo" field or directly use the specific endpoints for each dataset in the request.

The response is asynchronous, and you can set a callback during the request to be notified when the data is available, without needing to repeatedly call the GET/request/{id} endpoint to check its status. If a callback is set, 'headers' is a mandatory field and can be used to declare all the headers the user wants to include in the callback (such as session_id).

RESPONSE EXAMPLE

POST/request

The response will contain the request ID, which can be used in a subsequent call to access the desired data:

{
    "data": {
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "RSSMRA90D15L117D",
      "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": "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 must be made to another endpoint with the previously obtained ID:

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

RESPONSE EXAMPLE

GET/IT-request/{id}

The response will contain the following information:

  • Name and Surname
  • Company name
  • VAT number
  • Tax code
  • Date and place of birth
  • Residential address
  • Fiscal domicile address
  • Registered office address
  • ATECO code and description
  • Date and Place of birth 
  • Gender
  • Phone number (landline or mobile)
  • Presence of negative events (protests, prejudicial events, bankruptcy procedures)
{
    "data": {
      "status": "COMPLETED",
      "date_request": "2021-04-09 17:09:42",
      "date_completion": "2021-04-09 17:40:57",
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "RSSCLD79R07H501O ",
      "tipo": [
        "anagrafica"
      ],
      "callback":"false",
      "esito": {
        "codice": 200,
        "info": "OK"
      }
      "timestamp": 1625232029,
      "owner": "impresa@openapi.it",
      "soggetto": {
        "code": "RSSCLD79R07H501O ",
        "risultato": "OK",
        "nome": Claudio,
        "cognome": Rossi,
        "deceduto": false,
        "decesso_data": null,
        "nascita_luogo": ROME,
        "data_luogo": 1970-10-01,
        "sesso": M,
        "residenza": {
          "indirizzo": "VIA OSTIENSE 11",
          "toponimo": "VIA,
          "via": "OSTIENSE",
          "numero_civico": "11",
          "comune": "ROME",
          "cap": "00127",
          "provincia": "RM"
        },
        "domicilio_fiscale": {
          "indirizzo": "VIA OSTIENSE 11",
          "toponimo": "VIA,
          "via": "OSTIENSE",
          "numero_civico": "11",
          "comune": "ROME",
          "cap": "00127",
          "provincia": "RM"
        },
        "denominazione": "ROSSI CLAUDIO",
        "partita_iva": "12485671007",
        "ateco_codice": "461901",
        "ateco_descrizione": "Agents and representatives of various products without predominance of any"
        "sede_legale": {
          "indirizzo": "VIALE F TOMMASO MARINETTI 221",
          "toponimo": "VIALE",
          "via": "F TOMMASO MARINETTI",
          "numero_civico": "221",
          "comune": "ROME",
          "cap": "00143",
          "provincia": "RM"
        }
        "utenze":[
          "061234567"          
        ],
        "negativita": {
          "protests": false,
          "prejudicials": false,
          "procedures": false
        }
      }
    },
    "success": true,
    "message": "",
    "error": null
  }
  

CONDITIONS AND USAGE OF THE SERVICE

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

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

Requests made outside of these hours or days are queued and processed with priority on the next business day.

As per the contractual conditions, the service has daily rate limit restrictions to ensure proper service management.

If you would like a personalized service, contact us here.

Sign Up

Do you need help?

Haven't found the answer you're looking for?

Fill in all the details, we will get back to you as soon as possible!

Frequently Asked Questions

Through a quick check, it allows assessment of the financial reliability of the professional. This tool is useful for companies, financial institutions, and business partners who need to quickly verify the economic stability of freelancers before initiating collaborations.

What is the Check Freelancers?

With the Check Freelancers service, you can obtain the following information:

  • First and Last Name
  • Company Name
  • VAT Number
  • Tax Code
  • Date and Place of Birth
  • Residential Address
  • Fiscal Domicile Address
  • Legal Headquarters Address
  • ATECO Code and Description
  • Date and Place of Birth
  • Gender
  • Phone Number (landline or mobile)
  • Presence of negative events (protests, adverse records, insolvency proceedings)
What information can I obtain with the Check Freelancers?

It is possible to obtain data in structured formats such as JSON or XML, which are particularly useful for automatic integration into computer systems or for data processing through specific software.

In what formats are the information available?

The Check Freelancers is designed for various categories of users who need to assess the risk and financial stability of freelance professionals, including:

  • Companies wishing to evaluate the solvency and risk of collaborating with freelancers.
  • Banks and financial institutions to verify the financial stability of professionals before granting credit.
  • Legal and tax consultants to analyze the risks associated with specific professionals.
  • Investors interested in assessing the stability of their consultants or suppliers.
  • Administrative departments managing commercial relationships with external professionals.
Who is the Check Freelancers  intended for?

Information is provided via API within 2 hours. This timeframe ensures the rapid availability of requested data, allowing users to efficiently integrate the information into their systems.

What are the service processing times?

Requests are processed exclusively on business days, from 9:00 AM to 7:00 PM. Those submitted outside these hours or during holidays will be queued and handled with priority on the next business day.

Is the service available 24/7?

The cost of the Check Freelancers for each individual request via recharge is €2.20 + VAT.

What are the costs of the Check Freelancers?