Atoka API User Reference
Companies package "Shares"
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 |
|---|---|---|---|---|---|---|
| beneficialOwnerOf[] | list of companies for which this company is the beneficial owner | - | - | |||
| beneficialOwnerOf[].active | is the beneficial owner active? | true | false | - | |||
| beneficialOwnerOf[].cervedId Private field | Cerved ID of the beneficial owner | int | - | |||
| beneficialOwnerOf[].id | Atoka ID of the beneficial owner | "string" | - | |||
| beneficialOwnerOf[].legalName | legal name of the beneficial owner | "string" | - | |||
| beneficialOwnerOf[].name | name of the beneficial owner | "string" | - | |||
| beneficialOwnerOf[].stopReason | if the beneficial owner is not a person, it means Atoka could not traverse the ownership tree to an actual beneficial owner; in this case, the topmost company is considered the beneficial owner, and this field represents the type of company that made the computation of the true owner stop | "string" | - | |||
| beneficialOwners[] | list of beneficial owners of the company | - | - | |||
| beneficialOwners[].active | is the beneficial owner active? (available only if | true | false | - | |||
| beneficialOwners[].birthDate Private field | birth date of the subject holding the position (available only if | date | - | |||
| beneficialOwners[].birthPlace.macroregion Private field | macro region of the person birth place (available only if | "string" | - | |||
| beneficialOwners[].birthPlace.municipality Private field | municipality of the person birth place (available only if | "string" | - | |||
| beneficialOwners[].birthPlace.province Private field | province of the person birth place (available only if | "string" | - | |||
| beneficialOwners[].birthPlace.provinceCode Private field | province code of the person birth place (available only if | "string" | - | |||
| beneficialOwners[].birthPlace.region Private field | region of the person birth place (available only if | "string" | - | |||
| beneficialOwners[].birthPlace.state Private field | state of the person birth place. This field could change in future due to language depencencies (available only if | "string" | - | |||
| beneficialOwners[].birthPlace.stateCode Private field | state code of the person birth place (available only if | "string" | - | |||
| beneficialOwners[].cervedId Private field | Cerved ID of the beneficial owner | int | - | |||
| beneficialOwners[].company | is the beneficial owner a company or a person? | true | false | - | |||
| beneficialOwners[].id | Atoka ID of the beneficial owner | "string" | - | |||
| beneficialOwners[].legalName | legal name of the beneficial owner (available only if | "string" | - | |||
| beneficialOwners[].name | name of the beneficial owner | "string" | - | |||
| beneficialOwners[].stopReason | if the beneficial owner is not a person, it means Atoka could not traverse the ownership tree to an actual beneficial owner; in this case, the topmost company is considered the beneficial owner, and this field represents the type of company that made the computation of the true owner stop | "string" | - | |||
| beneficialOwners[].taxId Private field | the tax ID ("codice fiscale") of the person (available only if | "string" | - | |||
| fiduciaria Private field | is the company a fiduciaria? | true | false | fiduciaria | |||
| shareholders[] | list of shares that people or other companies may hold in a company | - | - | |||
| shareholders[].active | is the company holding the share active? (available only if | true | false | - | |||
| shareholders[].amount | amount of shares owned | float | - | |||
| shareholders[].birthDate Private field | birth date of the subject holding the position (available only if | date | - | |||
| shareholders[].birthPlace.macroregion Private field | macro region of the person birth place (available only if | "string" | - | |||
| shareholders[].birthPlace.municipality Private field | municipality of the person birth place (available only if | "string" | - | |||
| shareholders[].birthPlace.province Private field | province of the person birth place (available only if | "string" | - | |||
| shareholders[].birthPlace.provinceCode Private field | province code of the person birth place (available only if | "string" | - | |||
| shareholders[].birthPlace.region Private field | region of the person birth place (available only if | "string" | - | |||
| shareholders[].birthPlace.state Private field | state of the person birth place. This field could change in future due to language depencencies (available only if | "string" | - | |||
| shareholders[].birthPlace.stateCode Private field | state code of the person birth place (available only if | "string" | - | |||
| shareholders[].cervedId Private field | Cerved ID of the person or company holding the share | int | - | |||
| shareholders[].company | is the subject holding the share a company or a person? | true | false | - | |||
| shareholders[].id | Atoka ID of the person or company holding the share | "string" | - | |||
| shareholders[].lastUpdate | last time this position was updated | date | - | |||
| shareholders[].legalName | legal name of the company holding the share (available only if | "string" | - | |||
| shareholders[].name | name of the person or company holding the share | "string" | - | |||
| shareholders[].ratio | percentage of shares owned | float | - | |||
| shareholders[].taxId Private field | the tax ID ("codice fiscale") of the person (available only if | "string" | - | |||
| shareholders[].typeOfRight | type of right related to the share | "string" | - | |||
| sharesOwned[].active | is the company in which the share is held active? | true | false | - | |||
| sharesOwned[].amount | amount of the share | float | - | |||
| sharesOwned[].cervedId Private field | Cerved ID (if present) of company the share is held in | int | - | |||
| sharesOwned[].id | ID of the company the share is held in | "string" | - | |||
| sharesOwned[].lastUpdate | last time this share was updated | date | - | |||
| sharesOwned[].legalName | legal name of the company the share is held in | "string" | - | |||
| sharesOwned[].name | name of the company the share is held in | "string" | - | |||
| sharesOwned[].ratio | percentage of the share | float | - | |||
| sharesOwned[].typeOfRight | type of right related to the share | "string" | - |
Example JSON fragment for package
{"sharesOwned": [{"id": "foo", "cervedId": 42, "active": false, "name": "foo", "legalName": "foo", "ratio": 0.42, "amount": 0.42, "lastUpdate": "2015-12-24", "typeOfRight": "foo" },...],"shareholders": [{"taxId": "DOEJHN90A01H501H", "birthDate": "2015-12-24", "birthPlace": {"municipality": "Roma", "province": "Roma", "provinceCode": "RM", "region": "Lazio", "macroregion": "Centro", "state": "Italia", "stateCode": "it" },"id": "foo", "cervedId": 42, "company": false, "active": false, "name": "foo", "legalName": "foo", "ratio": 0.42, "amount": 0.42, "lastUpdate": "2015-12-24", "typeOfRight": "foo" },...],"beneficialOwners": [{"id": "foo", "cervedId": 42, "company": false, "active": false, "name": "foo", "legalName": "foo", "stopReason": "foo", "taxId": "DOEJHN90A01H501H", "birthDate": "2015-12-24", "birthPlace": {"municipality": "Roma", "province": "Roma", "provinceCode": "RM", "region": "Lazio", "macroregion": "Centro", "state": "Italia", "stateCode": "it" }},...],"beneficialOwnerOf": [{"id": "foo", "cervedId": 42, "active": false, "name": "foo", "legalName": "foo", "stopReason": "foo" },...],"fiduciaria": false }