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 company=true)

true | false -
beneficialOwners[].birthDate Private field

birth date of the subject holding the position (available only if company=false)

date -
beneficialOwners[].birthPlace.macroregion Private field

macro region of the person birth place (available only if company=false)

"string" -
beneficialOwners[].birthPlace.municipality Private field

municipality of the person birth place (available only if company=false)

"string" -
beneficialOwners[].birthPlace.province Private field

province of the person birth place (available only if company=false)

"string" -
beneficialOwners[].birthPlace.provinceCode Private field

province code of the person birth place (available only if company=false)

"string" -
beneficialOwners[].birthPlace.region Private field

region of the person birth place (available only if company=false)

"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 company=false)

"string" -
beneficialOwners[].birthPlace.stateCode Private field

state code of the person birth place (available only if company=false)

"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 company=true)

"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 company=false)

"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 company=true)

true | false -
shareholders[].amount

amount of shares owned

float -
shareholders[].birthDate Private field

birth date of the subject holding the position (available only if company=false)

date -
shareholders[].birthPlace.macroregion Private field

macro region of the person birth place (available only if company=false)

"string" -
shareholders[].birthPlace.municipality Private field

municipality of the person birth place (available only if company=false)

"string" -
shareholders[].birthPlace.province Private field

province of the person birth place (available only if company=false)

"string" -
shareholders[].birthPlace.provinceCode Private field

province code of the person birth place (available only if company=false)

"string" -
shareholders[].birthPlace.region Private field

region of the person birth place (available only if company=false)

"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 company=false)

"string" -
shareholders[].birthPlace.stateCode Private field

state code of the person birth place (available only if company=false)

"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 company=true)

"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 company=false)

"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
}