Get all people lists
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.
What you need
At least one people list reachable from your API key. Create one in the Specter app (then share it with the API from the list’s three-dot menu (⋯) by turning on “Share to API”), or via the API with Create people list (lists created via the API are shared automatically). Global lists curated by Specter are always reachable.
Behaviour
- Each list object includes the number of people in the list.
is_globalmarks a list curated by Specter, andshared_withcarries the user IDs the list is shared with, or an empty array when it is not shared.- Lists shared only within your team are not returned.
- To retrieve the person IDs in a list, call Get people list with that list’s ID.
What you do next
- Open a list’s people. Pull them with Get people list results.
- Build a new list. Create one with Create people list.
Authorizations
Response
The people lists
List Id
"5ab9d938-42cf-4306-963e-1911000ef5dd"
Name of the list
"Test delete a people list"
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.
Date list was created
"2026-06-30T10:14:59.520784Z"
Date the list was last updated
"2026-06-30T10:14:59.520784Z"
The number of people in this list
3