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 }