Skip to main content
GET
Get a contacts list

Authorizations

Authorization
string
header
required

Account API key passed in the Authorization header

Path Parameters

contactsListID
string
required

Contacts list UUID

Query Parameters

account_id
string

Target account UUID. Required for staff; ignored for customer keys.

Response

OK

account_id
string
required

Owning account UUID

company_linkedin_ids
string[] | null
required

LinkedIn company IDs attached to the list

contacts_count
integer<int64>
required

Number of contacts currently in the list

created_at
string<date-time>
required

Creation timestamp

id
string
required

Contacts list UUID

is_managed
boolean
required

When true, the list is read-only for the account user and writable only via this staff API

name
string
required

List name

tags
string[] | null
required

User-side organizational tags (writable on managed lists)

assignee
string

Email of the assigned owner

created_by_user_email
string

Email of the creator (or ops attribution for managed lists)