Atoka API User Reference

Companies package "Cerved Groups"

Available fields
Description
Data
Used by filters
Facet
Match
info.numberOfItems

total number of items in the group

int -
info.numberOfRelationships

total number of relationships between items in the group

int -
info.numberOfRoots

total number of roots in the graph of the group; roots are nodes without entering-edges

int -
items[].ateco[].code

codice ATECO 2007 (the most specific one)

"string" -
items[].ateco[].description

short description of ATECO 2007 code

"string" -
items[].ateco[].rootCode

the class of the ATECO 2007 code

"string" -
items[].founded

foundation date of the company

date -
items[].id

atoka ID of the item

"string" -
items[].latestBalanceSheet.date

balance sheet closing date ("data di chiusura del bilancio")

date -
items[].latestBalanceSheet.revenue

Revenue ("ricavi")

int -
items[].latestBalanceSheet.year

year (from the balance sheet closing date)

int -
items[].latestEmployees.date

date where the number of employees is referring to

date -
items[].latestEmployees.value

total number of employees (not considering the contract type)

int -
items[].latestEmployees.year

year of this record

int -
items[].name

(full) name of the person or company

"string" -
items[].taxId

the tax ID ("codice fiscale") of the person or company

"string" -
items[].type

the item type

"company", "person" -
items[].vat

the VAT ID ("partita IVA") of the company

"string" -
relationships[].id1

the source ID of the relationship

"string" -
relationships[].id2

the target ID of the relationship

"string" -
relationships[].ratio

the ownership ratio; multiply this number by 100 to get the ownership percentage

float -
relationships[].source

source of the relationship

"Bilancio di esercizio", "Bilancio consolidato", "Elenco soci", "Visura", "Cebi" -
relationships[].type

type of the relationship

"Controllata", "Collegata", "Altre" -
Example JSON fragment for package
{ // Companies package "Cerved Groups"
"info": {
"numberOfItems": int, // total number of items in the group
"numberOfRelationships": int, // total number of relationships between items in the group
"numberOfRoots": int // total number of roots in the graph of the group; roots are nodes without entering-edges
},
"items": [
{
"id": "string", // atoka ID of the item
"type": "string", // the item type
"name": "string", // (full) name of the person or company
"vat": "string", // the VAT ID ("partita IVA") of the company
"taxId": "string", // the tax ID ("codice fiscale") of the person or company
"founded": "date (in YYYY-MM-DD format)", // foundation date of the company
"ateco": [
{ // ATECO code
},
...
],
"latestBalanceSheet": {
"year": int, // year (from the balance sheet closing date)
"date": "date (in YYYY-MM-DD format)", // balance sheet closing date ("data di chiusura del bilancio")
"revenue": int // Revenue ("ricavi")
},
"latestEmployees": {
"year": int, // year of this record
"date": "date (in YYYY-MM-DD format)", // date where the number of employees is referring to
"value": int // total number of employees (not considering the contract type)
}
},
...
],
"relationships": [
{
"id1": "string", // the source ID of the relationship
"id2": "string", // the target ID of the relationship
"ratio": float, // the ownership ratio; multiply this number by 100 to get the ownership percentage
"source": "string", // source of the relationship
"type": "string" // type of the relationship
},
...
]
}