Get investor list
Returns information about an investor list created or shared with the API, including the investors it contains.
What you need
You need a investor list ID. Get one from Get all investor 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
- Open a single investor. Pass an
investor_idto Get investor by ID.
Authorizations
Path Parameters
The ID of the list being requested.
Response
The list including investor ids
List Id
"5868fd24-b559-44db-8647-7535bd58451a"
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 investors included in this list
Date (YYYY:MM:DD) the list was created.
"2026-07-17T16:22:17.352985Z"
Date (YYYY:MM:DD) the list was last updated.
"2026-07-17T16:22:17.352985Z"