Get all people lists
People Lists
Get all people lists
What it does
Returns all people lists available to your API key—lists created via the API, shared with the API in the UI, or shared globally.
Why you’d use it
Discover which people cohorts you can work with and see their sizes before fetching individual records.
Key behaviours
- Each list object includes the number of people in the list.
- To retrieve the people IDs in a list, call the corresponding GET endpoint with that list’s ID.
- Only lists that meet the availability criteria above are returned.
GET
Get all people lists
Authorizations
Response
The people lists
List Id
Example:
"b73c8bed-3b92-48f9-a879-40ee114dca03"
Name of the list
Example:
"Favourites"
Date list was created
Example:
"2024-11-14T10:36:12.625Z"
Date the list was last updated
Example:
"2024-11-14T10:36:12.625Z"
This flags lists recommended by Specter for all users
Example:
false
The number of people in this list
Example:
10
The user ids of the users this list is shared with
User Id