Get people list
People Lists
Get people list
Returns information about a people list created or shared with the API, including the people it contains.
Free. This call does not consume credits.
What you need
A list ID (UUID); get one from Get all people lists.
Behaviour
listIdmust be a UUID, otherwise400.- Returns
404if the list doesn’t exist or isn’t visible to the API.
What you do next
- Get full people data. Pull profiles via Get people list results.
- Open a single person. Pass a
person_idto Get person by ID.
GET
Get people list
Authorizations
Path Parameters
The ID of the list being requested.
Response
The list including people ids
List Id
Example:
"dbc97c77-8928-434b-9d62-1b596719ec23"
Name of the list
Example:
"My Watchlist"
The people included in this list
Date list was created
Example:
"2026-07-17T16:22:17.608512Z"
Date the list was last updated
Example:
"2026-07-17T16:22:17.608512Z"