Atoka API User Reference
People package "Companies"
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 | Stats |
|---|---|---|---|---|---|---|
| count | total number of companies this person has positions in | int | companiesCountMin companiesCountMax | |||
| items[] | list of companies this person has positions in | - | - | |||
| items[].atokaIndicators.innovation.categoryScore | Innovation score bracket of the company compared to companies with the same Ateco code, computed by Atoka. See the glossary for more details. Brackets are "low" (0-39), "medium" (40-59), "high" (60-89), and "top" (90-100). | "low", "medium", "high", "top" | companiesInnovationCategoryScore | |||
| items[].atokaIndicators.innovation.score | Innovation score bracket of the company compared to all other companies, computed by Atoka. See the glossary for more details. Brackets are "low" (0-39), "medium" (40-59), "high" (60-89), and "top" (90-100). | "low", "medium", "high", "top" | companiesInnovationScore | |||
| items[].atokaIndicators.webCentrality.categoryScore | Web centrality score bracket of the company compared to companies with the same Ateco code, computed by Atoka. See the glossary for more details. Brackets are "low" (0-39), "medium" (40-59), "high" (60-89), and "top" (90-100). | "low", "medium", "high", "top" | companiesWebCentralityCategoryScore | |||
| items[].atokaIndicators.webCentrality.score | Web centrality score bracket of the company compared to all other companies, computed by Atoka. See the glossary for more details. Brackets are "low" (0-39), "medium" (40-59), "high" (60-89), and "top" (90-100). | "low", "medium", "high", "top" | companiesWebCentralityScore | |||
| items[].base.ateco[].code Private field | ATECO 2007 code (the most specific one) | "string" | companiesAteco companiesAtecoExclude | |||
| items[].base.ateco[].description Private field | short description of ATECO 2007 code | "string" | - | |||
| items[].base.ateco[].rootCode Private field | the class of the ATECO 2007 code | "string" | - | |||
| items[].base.founded | when the company started its activity | date | companiesAgeMin companiesAgeMax companiesFoundedFrom companiesFoundedTo | |||
| items[].base.legalForms[].level | int | - | ||||
| items[].base.legalForms[].name | legal status of the company (e.g. "Società In Accomandita Semplice") | "string" | legalForms | |||
| items[].base.publicAdministration | is the company a public administration? | true | false | companiesPA | |||
| items[].base.registeredAddress.fullAddress | complete address of this location | "string" | - | |||
| items[].base.registeredAddress.hamlet | hamlet of this location | "string" | - | |||
| items[].base.registeredAddress.macroregion | macro region for this location | "string" | companiesMacroregions companiesMacroregionsExclude | |||
| items[].base.registeredAddress.municipality | municipality for this location | "string" | companiesMunicipalities companiesMunicipalitiesExclude | |||
| items[].base.registeredAddress.postcode | postcode for this location | "string" | companiesPostcodes companiesPostcodesExclude | |||
| items[].base.registeredAddress.province | province for this location | "string" | companiesProvinces companiesProvincesExclude | |||
| items[].base.registeredAddress.provinceCode | code of the province for this location | "string" | - | |||
| items[].base.registeredAddress.region | region for this location | "string" | companiesRegions companiesRegionsExclude | |||
| items[].base.registeredAddress.state | state for this location | "string" | - | |||
| items[].base.registeredAddress.stateCode | stateCode for this state | "string" | - | |||
| items[].base.registeredAddress.streetName | name of the street where the company is located | "string" | - | |||
| items[].base.registeredAddress.streetNumber | number of building where the company is located | "string" | - | |||
| items[].base.registeredAddress.toponym | toponym describing the address (e.g. 'via', 'piazza' etc.) | "string" | - | |||
| items[].base.startup | is the company a startup? | true | false | companiesStartup | |||
| items[].biography | biography of the person | "string" | - | |||
| items[].cLevels[] | C-Level positions this person has in the company (CEO, CTO, CFO, ...) | "string" | cLevels | |||
| items[].cervedId Private field | Cerved ID of the company | int | companiesCervedIds | |||
| items[].economics.balanceSheets[].revenue | last known revenue ("ricavi") of the company | float | companiesRevenueMin companiesRevenueMax companiesRevenueUnknown | |||
| items[].economics.employees[].latest | is this the last available employees count? | true | false | - | |||
| items[].economics.employees[].value | total number of employees (not considering the contract type) | int | companiesEmployeesMin companiesEmployeesMax companiesEmployeesUnknown | |||
| items[].emails[].address | direct email of this person | "string" | - | |||
| items[].emails[].verified | was this email verified? | true | false | - | |||
| items[].id | Unique ID that you can use throughout the API endpoints to reference to this company | "string" | companies relatedTo | |||
| items[].legalName | legal name of the company | "string" | - | |||
| items[].name | name of the company | "string" | - | |||
| items[].phones[].number | phone number of this person | "string" | phones=* | |||
| items[].phones[].source | the source of the phone number | "phone books", "web" | - | |||
| items[].phones[].verified | whether the phone has been verified by cross-checks on different sources or not | true | false | - | |||
| items[].roles[].name | name of the role covered | "string" | companiesRoles | |||
| items[].roles[].official | whether this is an officially recorded role | true | false | - | |||
| items[].roles[].since | from which date the person have the role | date | - | |||
| items[].roles[].sources[] | sources for this relation | "string" | - | |||
| items[].technologies.hasEcommerce | does the company have an ecommerce? | true | false | companiesEcommerce |
Example JSON fragment for package
{"count": 3, "items": [{"id": "foo", "cervedId": 42, "name": "foo", "legalName": "foo", "cLevels": ["foo",...],"roles": [{"name": "foo", "since": "2015-12-24", "official": false, "sources": ["foo",...]},...],"biography": "foo", "phones": [{"number": "foo", "verified": false, "source": "phone books" },...],"emails": [{"address": "foo", "verified": false },...],"atokaIndicators": {"innovation": {"score": "low", "categoryScore": "low" },"webCentrality": {"score": "low", "categoryScore": "low" }},"base": {"ateco": [{"code": "64.92.09", "description": "altre attività creditizie nca", "rootCode": "G" },...],"founded": "2015-12-24", "legalForms": [{"level": 42,"name": "foo" },...],"registeredAddress": {"fullAddress": "foo", "toponym": "foo", "streetName": "foo", "streetNumber": "foo", "hamlet": "foo", "postcode": "foo", "municipality": "foo", "province": "foo", "provinceCode": "foo", "region": "foo", "macroregion": "foo", "state": "foo", "stateCode": "foo" },"startup": false, "publicAdministration": false },"economics": {"balanceSheets": [{"revenue": 0.42 },...],"employees": [{"latest": false, "value": 42 },...]},"technologies": {"hasEcommerce": false }},...]}