Get all company lists
Returns the company 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 company 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 company 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 companies 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 company IDs in a list, call Get company list with that list’s ID.
What you do next
- Open a list’s companies. Pull them with Get company list results.
- Build a new list. Create one with Create company list.
Authorizations
Response
The companies lists
List Id
"744319ce-2cf1-4d7b-809b-ecfedabaf6f0"
Name of the list
"New"
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
"2025-01-03T10:11:20.655375Z"
Date the list was last updated
"2025-01-03T10:11:20.655375Z"
The number of companies in this list
2