Person Objects¶
Person objects have the following fields:
Basics¶
- name (string)
A person’s preferred full name (required)
- image (string, null)
A URL of a head shot (required)
- contact_details (array)
Contact information for this entity. (required, minItems: 0)
Each element in contact_details is an object with the following keys:
- note (string, null)
for grouping data by location/etc. (required)
- type (string)
type of contact (e.g. phone, email, address) (required)
- value (string)
actual phone number/email address/etc. (required)
- label (string, null)
human-readable label (required)
- links (array)
URLs for documents about the person (required, minItems: 0)
Each element in links is an object with the following keys:
- note (string, null)
A note, e.g. ‘Wikipedia page’ (required)
- url (string)
A URL for a document about the person (required)
Extended Details¶
- sort_name (string, null)
A name to use in a lexicographically ordered list (required)
- family_name (string, null)
One or more family names (required)
- given_name (string, null)
One or more primary given names (required)
- gender (string, null)
A gender (required)
- summary (string, null)
A one-line account of a person’s life (required)
- national_identity (string, null)
A national identity (required)
- biography (string, null)
An extended account of a person’s life (required)
- birth_date (string, null)
A date of birth (required)
(must match format:
^[0-9]{4}(-[0-9]{2}){0,2}$
)- death_date (string, null)
A date of death (required)
(must match format:
^[0-9]{4}(-[0-9]{2}){0,2}$
)
Alternate Names/Identifiers¶
- identifiers (array)
IDs other than the primary ID that the object may be known by. (required, minItems: 0)
Each element in identifiers is an object with the following keys:
- scheme (string, null)
What service this identifier is used by. (required)
- identifier (string)
The 3rd-party identifier, such as OKL0001000. (required)
- other_names (array)
Alternate or former names for this object. (required, minItems: 0)
Each element in other_names is an object with the following keys:
- note (string, null)
An optional note describing where this alternate name came from or its relationship to the entity. (required)
- name (string)
An alternate name this object is sometimes known by. (required)
- end_date (string, null)
The date at which this name was no longer valid. (null if still valid/valid indefinitely) (required)
(must match format:
^[0-9]{4}(-[0-9]{2}){0,2}$
)- start_date (string, null)
The date at which this name became valid.(null if unknown/valid indefinitely) (required)
(must match format:
^[0-9]{4}(-[0-9]{2}){0,2}$
)
Common Fields¶
- updated_at (string, datetime, null)
The time at which the resource was last modified (required)
- created_at (string, datetime, null)
The time at which the resource was created (required)
- sources (array)
URLs for sources relating to the object (required, minItems: 1)
Each element in sources is an object with the following keys:
- url (string)
URL of resource used to collect information (required)
- note (null, string)
note about what information this URL was used for (required)