Skip to main content
GET
Get all company lists

Authorizations

X-API-Key
string
header
required

Response

The companies lists

id
string<uuid>
required

List Id

Example:

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

name
string
required

Name of the list

Example:

"New"

is_global
boolean
default:false

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[]

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> | null

Date list was created

Example:

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

updated_at
string<date-time> | null

Date the list was last updated

Example:

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

company_count
integer
default:0

The number of companies in this list

Example:

2