Get people list
Returns information about a people list created or shared with the API, including the people it contains.
What you need
You need a people list ID. 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.
Authorizations
Path Parameters
The ID of the list being requested.
Response
The list including people ids
List Id
"dbc97c77-8928-434b-9d62-1b596719ec23"
Name of the list
"My Watchlist"
true when the list is a global list curated by Specter and available to all users. false for lists owned by your organization.
false
The Specter user IDs this list is shared with, or an empty array when it is not shared. Resolve an ID to a person with Get organization members.
The people included in this list
Date list was created
"2026-07-17T16:22:17.608512Z"
Date the list was last updated
"2026-07-17T16:22:17.608512Z"