Atoka API User Reference

People package "Professional Registries"

This package contains the professional registries ("albi") in which the person is enrolled, such as those for lawyers, notaries, chartered accountants, and many other professions.

Facet counts for fields nested under items represent unique people, not professional registry entries.

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

number of professional registry entries for this person

int -
items[]

professional registry entries for this person

- -
items[].enrollmentDate

date on which the person enrolled in the professional registry. This field is available for avvocati, commercialisti, geologi, geometri, ingegneri, and revisori legali; it may be missing from individual entries

date professionalRegistriesEnrollmentDateFrom professionalRegistriesEnrollmentDateTo
items[].isAuditor

true iff the person is also registered as an auditor ("revisore contabile"). This field is available only for entries in the commercialisti registry

true | false professionalRegistriesIsAuditor
items[].payload Private field

raw data supplied by the professional registry; its structure depends on the registry

{"foo": "bar"} -
items[].payload.* Private field - -
items[].regNumber

registration number in the professional registry

"string" professionalRegistriesRegNumbers
items[].registry

professional registry in which the person is enrolled

"agronomi forestali", "assistenti sociali", "attuari", "avvocati", "biologi", "commercialisti", ... professionalRegistries professionalRegistriesExclude
items[].studioAddress.macroregion

macro region of the professional office

"string" professionalRegistriesStudioAddressMacroregions professionalRegistriesStudioAddressMacroregionsExclude
items[].studioAddress.municipality

municipality of the professional office

"string" professionalRegistriesStudioAddressMunicipalities professionalRegistriesStudioAddressMunicipalitiesExclude
items[].studioAddress.province

province of the professional office

"string" professionalRegistriesStudioAddressProvinces professionalRegistriesStudioAddressProvincesExclude
items[].studioAddress.provinceCode

province code of the professional office

"string" -
items[].studioAddress.region

region of the professional office

"string" professionalRegistriesStudioAddressRegions professionalRegistriesStudioAddressRegionsExclude
Example JSON fragment for package
{
"count": 1,
"items": [
{
"enrollmentDate": "2015-12-24",
"isAuditor": false,
"regNumber": "52101",
"registry": "avvocati",
"studioAddress": {
"macroregion": "foo",
"region": "foo",
"province": "foo",
"provinceCode": "foo",
"municipality": "foo"
},
"payload": {
"foo": undefined,
"bar": undefined,
"baz": undefined
}
},
...
]
}