Atoka API User Reference

Companies package "Cerved Groups"

API tokens are configured to access only the packages each user needs; this means you might not have access to the content of this package. Ask your sales contact!

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

ATECO 2007 code (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[].cervedId Private field

Cerved ID of the item

int -
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
{
"info": {
"numberOfItems": 42,
"numberOfRelationships": 42,
"numberOfRoots": 42
},
"items": [
{
"id": "foo",
"cervedId": 42,
"type": "company",
"name": "foo",
"vat": "foo",
"taxId": "foo",
"founded": "2015-12-24",
"ateco": [
{
"code": "64.92.09",
"description": "altre attività creditizie nca",
"rootCode": "G"
},
...
],
"latestBalanceSheet": {
"year": 42,
"date": "2015-12-24",
"revenue": 42
},
"latestEmployees": {
"year": 42,
"date": "2015-12-24",
"value": 42
}
},
...
],
"relationships": [
{
"id1": "foo",
"id2": "foo",
"ratio": 0.42,
"source": "Bilancio di esercizio",
"type": "Controllata"
},
...
]
}