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)