Skip to main content
GET
Get all people lists

Authorizations

X-API-Key
string
header
required

Response

The people lists

id
string
required

List Id

Example:

"5ab9d938-42cf-4306-963e-1911000ef5dd"

name
string
required

Name of the list

Example:

"Test delete a people list"

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:

"2026-06-30T10:14:59.520784Z"

updated_at
string<date-time>

Date the list was last updated

Example:

"2026-06-30T10:14:59.520784Z"

people_count
number

The number of people in this list

Example:

3