Get a contacts list

curl --request GET \
  --url https://api.tamtam.ai/api/v2/contacts-lists/{contactsListID} \
  --header 'Authorization: <api-key>'

{
  "account_id": "<string>",
  "company_linkedin_ids": [
    "<string>"
  ],
  "contacts_count": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "is_managed": true,
  "name": "<string>",
  "tags": [
    "<string>"
  ],
  "assignee": "<string>",
  "created_by_user_email": "<string>"
}

GET

contacts-lists

{contactsListID}

Get a contacts list

curl --request GET \
  --url https://api.tamtam.ai/api/v2/contacts-lists/{contactsListID} \
  --header 'Authorization: <api-key>'

{
  "account_id": "<string>",
  "company_linkedin_ids": [
    "<string>"
  ],
  "contacts_count": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "is_managed": true,
  "name": "<string>",
  "tags": [
    "<string>"
  ],
  "assignee": "<string>",
  "created_by_user_email": "<string>"
}

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

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

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