Skip to main content
GET
Get all company lists

Authorizations

X-API-Key
string
header
required

Response

The companies lists

id
string
required

List Id

Example:

"744319ce-2cf1-4d7b-809b-ecfedabaf6f0"

name
string
required

Name of the list

Example:

"New"

is_global
boolean
required

true when the list is a global list curated by Specter and available to all users. false for lists owned by your organization.

Example:

false

shared_with
string[]
required

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.

Example:
created_at
string<date-time>

Date list was created

Example:

"2025-01-03T10:11:20.655375Z"

updated_at
string<date-time>

Date the list was last updated

Example:

"2025-01-03T10:11:20.655375Z"

company_count
number

The number of companies in this list

Example:

2