The API was replaced by the /IT-splitpayment endpoint available in Company
For information on companies subject to Split Payment, discover the new API Company service
Deprecated starting from 2024-12-31
All the knowledge you need
Here you can find some advice to consider to approach this API. If you prefer, we provide code samples, OAS3 documentation, the ability to try the API live via the Swagger UI or import the entire collection into Postman. We also offer a Sandbox environment where you can experiment with all kinds of requests completely free of charge.
Useful tips to start with
Italian Split Payment Companies
Get the token in the appropriate section before you start.
Use the the online tool or generate it via API. Set the expire date, a usefull name and now add a bunch of scopes to limit the possible actions your token can do.
- Oas file url https://console.openapi.com/oas/en/splitpayment.openapi.json
- Fork or import with Postman
- Production domain splitpayment.openapi.it
- Sandbox domain test.splitpayment.openapi.it
- Production Scopes 1
-
Sandbox Scopes 1
- GET test.splitpayment.openapi.it/root
Splitpayment (1.0.0)
Service web qui renvoie la liste des entreprises soumises au paiement fractionné et dont la TVA est versée par l'administration publique.
Toutes les entreprises
Liste de toutes les entreprises soumises au paiement fractionné
Authorizations:
bearerAuth
Responses
Response Schema: application/json
Array of objects (Company) | |
| success | boolean |
| message | string |
| error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://splitpayment.openapi.it/"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); CURLcode ret = curl_easy_perform(hnd);
Response samples
- 200
- 500
Content type
application/json
{
- "data": [
- {
- "cf": "00081070591",
- "den": "SIOG SOCIETA'ITALIANA OLEODOTTI DI GAETA SPA IN AMM.NE STRAORDINARIA",
- "dm": "1571270400",
- "categoria": "Societa' controllate di fatto dalla Presidenza del Consiglio dei Ministri e dai Ministeri",
- "update_timestamp": 1605031159
- {
- "cf": "00103540829",
- "den": "INDUSTRIA SICILIANA ACIDO FOSFORICO S.P.A.IN LIQUIDAZIONE",
- "dm": "1571270400",
- "categoria": "Societa' controllate di fatto dalla Presidenza del Consiglio dei Ministri e dai Ministeri",
- "update_timestamp": 1605031159
- {
- "cf": "00109940478",
- "den": "ANSALDOBREDA S.P.A.",
- "dm": "1571270400",
- "categoria": "Societa' controllate di fatto dalla Presidenza del Consiglio dei Ministri e dai Ministeri",
- "update_timestamp": 1605031159
- "success": true,
- "message": "3 aziende trovate",
- "error": null
Entreprise spécifique
Ce point final renvoie les données de l'entreprise identifiée par le numéro d'identification fiscale.
Authorizations:
bearerAuth
path Parameters
| cf required | string Example: 98040900171 Numéro d'identification fiscale ou numéro de TVA |
Responses
Response Schema: application/json
Array of objects (Company) | |
| success | boolean |
| message | string |
| error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://splitpayment.openapi.it/%7Bcf%7D"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); CURLcode ret = curl_easy_perform(hnd);
Response samples
- 200
- 404
- 500
Content type
application/json
{
- "data": [
- {
- "cf": "98040900171",
- "den": "FONDAZIONE BRESCIANA PER GLI STUDI ECONOMICO - GIURIDICI",
- "dm": "1571270400",
- "categoria": "Enti, fondazioni o societa' partecipate per una percentuale complessiva del capitale non inferiore al 70 per cento, dalle Amministrazioni Pubbliche",
- "update_timestamp": 1605031159
- "success": true,
- "message": "1 aziende trovate",
- "error": null