oauth
assets
album-assets
albums
libraries
people
server
users
List people
Copy
curl --request GET \
--url https://api.example.com/api/peopleCopy
{
"data": [
{
"id": "<string>",
"is_hidden": true,
"is_favorite": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"birth_date": "2023-12-25",
"asset_count": 123,
"thumbnail_face_id": "<string>",
"thumbnail_face_url": "<string>",
"asset_urls": {}
}
],
"has_more": true
}people
List people
Retrieves a paginated list of people, ordered by creation time, descending. Can be filtered by specific person IDs, name, or whether the person has been named.
GET
/
api
/
people
List people
Copy
curl --request GET \
--url https://api.example.com/api/peopleCopy
{
"data": [
{
"id": "<string>",
"is_hidden": true,
"is_favorite": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"birth_date": "2023-12-25",
"asset_count": 123,
"thumbnail_face_id": "<string>",
"thumbnail_face_url": "<string>",
"asset_urls": {}
}
],
"has_more": true
}Query Parameters
Max number of people to return (1-200)
Required range:
1 <= x <= 200Person ID to start listing people after
Include only people associated with this asset ID
Include only people associated with this album ID
Filter by specific person IDs (max 100)
Filter by name using case-insensitive substring matching
Filter by whether the person has a name assigned (true = named only, false = unnamed only)
Library ID (required if user has multiple libraries)
⌘I