Sign in

v64

OpenAPI 3.1.0raw.githubusercontent.com2026-08-016280256.4 KB
people

Get a person

Fetches one person's metadata by ID (name, asset count, thumbnail, etc.). Use this when you already have a person_id. The JSON response is metadata only; to get the photos that contain this person, use search_assets with person_ids or list_assets with person_ids.

get/api/people/{person_id}

Path parameters

person_idstring required

Person ID (with person_ prefix) to fetch. Carried by the person_id field on a face and by the entries of an asset's people field (returned with include=people).

Person ID (with person_ prefix) to fetch. Carried by the person_id field on a face and by the entries of an asset's people field (returned with include=people).

Query parameters

includestring[] nullable

Opt-in expansion fields. See list_people for supported values. Accepts multiple include= query params or a single comma-delimited value.

Opt-in expansion fields. See list_people for supported values. Accepts multiple include= query params or a single comma-delimited value.

Response

Successful Response

idstring required

Unique person identifier with 'person_' prefix

namestring nullable

Optional name assigned to this person

birth_datestring date nullable

Optional birth date of this person

is_hiddenboolean required

Whether this person should be hidden from the UI

is_favoriteboolean required

Whether this person is marked as a favorite

asset_countinteger nullable

Number of unique photos this person appears in, or null if not computed

thumbnail_face_idstring nullable

ID of the face resource used as this person's thumbnail

asset_urlsobject nullable

Asset variants from this person's thumbnail face. May be null when embedded in an AssetResponse; use /api/people endpoints for full person data.

created_atstring date-time required

When this person record was created

updated_atstring date-time required

When this person record was last updated