Skip to main content
GET
Get one campaign contact
The Dialer is a newly released product surface: depending on your account’s rollout stage, campaigns managed through this API may not yet be visible in your CloudTalk Dashboard.

Authorizations

Authorization
string
header
required

HTTP Basic Authentication. Use your API Access Key ID as the username and your API Access Key Secret as the password. Generate keys in the CloudTalk Dashboard under Account -> Settings -> API Keys (https://dashboard.cloudtalk.io/menu/account/settings/API-keys).

Path Parameters

campaignId
string
required

Dialer campaign ID.

Pattern: ^[1-9][0-9]*$
campaignContactId
string
required

Campaign-contact (membership) ID — campaign_contact_id from the contacts list, not the contact's own id.

Pattern: ^[1-9][0-9]*$

Response

The campaign contact with tag enrichment.

A campaign contact plus best-effort tag enrichment from Contacts.

campaign_contact_id
string

Membership row ID — the id used by the single-contact call.

Example:

"5100"

contact_id
string

The contact's ID in Contacts.

Example:

"88213"

display_name
string | null

Contact display name; null when the snapshot carries none.

Example:

"Jane Kowalski"

phone_number
string | null

Primary phone number — the first of the contact's ordered numbers.

Example:

"+421900123456"

queue_tag
enum<string>

Derived queue position (see the list call's description) — not the raw membership state.

Available options:
assigned,
scheduled,
completed,
dnc,
exhausted,
excluded,
fresh,
retry,
rescheduled,
favorite
Example:

"fresh"

attempt_count
integer

Completed attempts recorded for this membership.

Example:

0

next_eligible_at
string<date-time>

When the contact next becomes dialable (ISO 8601, UTC).

Example:

"2026-08-04T08:00:00.000Z"

owner_user_id
string | null

Agent a scheduled callback is pinned to; null when unpinned.

Example:

null

callback_notes
string | null

Free-text note attached to a scheduled callback; null otherwise.

Example:

null

tags
string[] | null

The contact's CURRENT tag names. Null means the enrichment was unavailable (unknown, not empty); an empty array means the contact genuinely has no tags.

Example: