case_idstring uuid required
rolesstring[] required
legal_representative shareholder
is_beneficial_ownerboolean required
Set to true if this individual ultimately owns or controls the main company
is_controlling_personboolean required
Set to true if this individual exercises control over the main company through means other than ownership (e.g. senior management, board member)
is_business_contactboolean required
Set to true if this individual should be contacted regarding the case
is_delegatorboolean required
Set to true if this individual is delegating its signing authority to the signatory of the case
is_signatoryboolean required
Set to true if this person has delegated authority to be a signatory of the case
is_relevantboolean required
first_namestring required
middle_namestring nullable required
May contain multiple middle names
maiden_namestring nullable required
emailstring email nullable required
birth_datestring date nullable required
Date in format ISO 8601(yyyy-MM-dd eg 2023-01-31)
birth_countrystring alpha-2 nullable required
birth_placestring nullable required
gender'male' | 'female' | 'other' nullable required
nationalitiesstring[] nullable required
Nationalities of the individual as ISO 3166-1 alpha-2 country codes
tax_identification_numberstring nullable required
social_security_numberstring nullable required
phone_numberstring e.164 nullable required
Phone number in E.164 format (eg +33123456789)
E.164 phoneNumber (eg +XXXXXXXXXXX)
positionstring nullable required
ownership_percentagenumber float nullable required
voting_rights_percentagenumber float nullable required
custom_propertiesobject required
Custom properties object in a format of key (string) / value (string | boolean | string[] | number | null) to read the individual.
Archived custom properties are omitted.
created_atstring date-time required
Creation date
Date time in format ISO 8601 (yyyy-MM-ddTHH:mm:ss.S+X eg 2023-01-31T13:30:00.000Z)
updated_atstring date-time required
Latest update date
Date time in format ISO 8601 (yyyy-MM-ddTHH:mm:ss.S+X eg 2023-01-31T13:30:00.000Z)
last_activity_atstring date-time required
Latest activity date
Date time in format ISO 8601 (yyyy-MM-ddTHH:mm:ss.S+X eg 2023-01-31T13:30:00.000Z)
property_originsobject
Property origin details keyed by property path, returned only when property_origin=true is provided.