Get all people lists
What it does
Returns the people lists reachable from your API key: lists created via the API, lists with “Share to API” turned on, and global lists curated by Specter. Lists shared only within your team are not returned.
Why you’d use it
Discover which people cohorts you can work with and see their sizes before fetching individual records.
Key behaviors
- 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.
Authorizations
Response
The people lists
List Id
"b73c8bed-3b92-48f9-a879-40ee114dca03"
Name of the list
"Favourites"
Date list was created
"2024-11-14T10:36:12.625Z"
Date the list was last updated
"2024-11-14T10:36:12.625Z"
This flags lists recommended by Specter for all users
false
The number of people in this list
10
The user ids of the users this list is shared with
User Id