Credit report
curl --request GET \
--url https://api.syrto.ai/companies/{fiscalCode}/credit-report \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.syrto.ai/companies/{fiscalCode}/credit-report"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.syrto.ai/companies/{fiscalCode}/credit-report', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.syrto.ai/companies/{fiscalCode}/credit-report",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.syrto.ai/companies/{fiscalCode}/credit-report"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.syrto.ai/companies/{fiscalCode}/credit-report")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syrto.ai/companies/{fiscalCode}/credit-report")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
"isConsolidated": false,
"latestFiledYear": 2023,
"identity": {
"legalName": "BARILLA G. E R. FRATELLI - SOCIETÀ PER AZIONI",
"legalForm": "S.p.A.",
"foundingYear": 1877,
"incorporationDate": "1877-01-01",
"isQuoted": false,
"vatNumber": "01654010345",
"fiscalCode": "01654010345",
"naceCode": "10.73",
"naceSection": "C",
"address": {
"line1": "Via Mantova 166",
"line2": null,
"locality": "Parma",
"postalCode": "43122",
"countryCode": "IT"
},
"foreignOwned": false,
"controllingEntity": null
},
"registry": {
"pec": "barilla@pec.example.it",
"cciaa": "PR-123456",
"rea": "PR-123456"
},
"headcount": {
"employees": 8760,
"asOf": "2023-12-31"
},
"risk": {
"protestsOfBill": false,
"insolvencyProceedings": false,
"insolvencyApplications": false,
"assetEncumbrances": false,
"officersWithRiskIndicators": false
},
"stateAids": {
"count": 12,
"countLast36Months": 3,
"amount": 1450000,
"amountLast36Months": 320000
},
"ownership": [
{
"name": "Barilla Holding S.p.A.",
"share": 0.85
}
],
"officers": [
{
"name": "Guido Barilla",
"role": "Chairman",
"roleCategory": "board"
}
],
"latest": {
"year": 2023,
"isForecasted": false,
"size": "L",
"statementDate": "2023-12-31",
"employees": 8760,
"employeesYoY": 0.03
},
"financials": [
{
"year": 2023,
"isForecasted": false,
"size": "L",
"statementDate": "2023-12-31",
"employees": 8760,
"employeesYoY": 0.03
},
{
"year": 2022,
"isForecasted": false,
"size": "L",
"statementDate": "2022-12-31",
"employees": 8505,
"employeesYoY": 0.02
}
]
},
"meta": {
"requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b",
"endpoint": "company-credit-report",
"usage": {
"quantity": 10,
"unit": "credits"
}
}
}{
"error": {
"code": "invalid_api_key",
"message": "The API key is not recognised.",
"requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b"
}
}{
"error": {
"code": "not_found",
"message": "No company matches that identifier.",
"requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b"
}
}{
"error": {
"code": "invalid_params",
"message": "Invalid request parameters.",
"requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b",
"details": [
{
"path": "path.fiscalCode",
"message": "fiscalCode must be an 11-digit tax/VAT code or a 16-character codice fiscale"
}
]
}
}{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded.",
"requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b"
}
}Interactive reference
Credit report
A full credit report: identity and registry data, risk indicators, headcount, state aids, ownership and officers, and several recent years of headline financials. Ownership and officers carry names only.
GET
/
companies
/
{fiscalCode}
/
credit-report
Credit report
curl --request GET \
--url https://api.syrto.ai/companies/{fiscalCode}/credit-report \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.syrto.ai/companies/{fiscalCode}/credit-report"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.syrto.ai/companies/{fiscalCode}/credit-report', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.syrto.ai/companies/{fiscalCode}/credit-report",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.syrto.ai/companies/{fiscalCode}/credit-report"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.syrto.ai/companies/{fiscalCode}/credit-report")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.syrto.ai/companies/{fiscalCode}/credit-report")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
"isConsolidated": false,
"latestFiledYear": 2023,
"identity": {
"legalName": "BARILLA G. E R. FRATELLI - SOCIETÀ PER AZIONI",
"legalForm": "S.p.A.",
"foundingYear": 1877,
"incorporationDate": "1877-01-01",
"isQuoted": false,
"vatNumber": "01654010345",
"fiscalCode": "01654010345",
"naceCode": "10.73",
"naceSection": "C",
"address": {
"line1": "Via Mantova 166",
"line2": null,
"locality": "Parma",
"postalCode": "43122",
"countryCode": "IT"
},
"foreignOwned": false,
"controllingEntity": null
},
"registry": {
"pec": "barilla@pec.example.it",
"cciaa": "PR-123456",
"rea": "PR-123456"
},
"headcount": {
"employees": 8760,
"asOf": "2023-12-31"
},
"risk": {
"protestsOfBill": false,
"insolvencyProceedings": false,
"insolvencyApplications": false,
"assetEncumbrances": false,
"officersWithRiskIndicators": false
},
"stateAids": {
"count": 12,
"countLast36Months": 3,
"amount": 1450000,
"amountLast36Months": 320000
},
"ownership": [
{
"name": "Barilla Holding S.p.A.",
"share": 0.85
}
],
"officers": [
{
"name": "Guido Barilla",
"role": "Chairman",
"roleCategory": "board"
}
],
"latest": {
"year": 2023,
"isForecasted": false,
"size": "L",
"statementDate": "2023-12-31",
"employees": 8760,
"employeesYoY": 0.03
},
"financials": [
{
"year": 2023,
"isForecasted": false,
"size": "L",
"statementDate": "2023-12-31",
"employees": 8760,
"employeesYoY": 0.03
},
{
"year": 2022,
"isForecasted": false,
"size": "L",
"statementDate": "2022-12-31",
"employees": 8505,
"employeesYoY": 0.02
}
]
},
"meta": {
"requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b",
"endpoint": "company-credit-report",
"usage": {
"quantity": 10,
"unit": "credits"
}
}
}{
"error": {
"code": "invalid_api_key",
"message": "The API key is not recognised.",
"requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b"
}
}{
"error": {
"code": "not_found",
"message": "No company matches that identifier.",
"requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b"
}
}{
"error": {
"code": "invalid_params",
"message": "Invalid request parameters.",
"requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b",
"details": [
{
"path": "path.fiscalCode",
"message": "fiscalCode must be an 11-digit tax/VAT code or a 16-character codice fiscale"
}
]
}
}{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded.",
"requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b"
}
}Authorizations
Org-scoped API key (sk_...), sent as Authorization: Bearer .
Path Parameters
An 11-digit tax/VAT code or a 16-character codice fiscale. Case-insensitive.
Pattern:
^(?:\d{11}|[A-Za-z0-9]{16})$Was this page helpful?
⌘I