List a campaign's contacts
Returns the campaign’s members ordered by dialing eligibility (next_eligible_at, then id), cursor-paginated. meta.total counts the filtered set, so it moves with queueTag and search.
queue_tag on each row is a derived queue position, not the raw membership state: an open agent hold reads assigned, a scheduled callback reads scheduled, terminal states read as themselves, and a pending contact reads its waterfall category (fresh, retry, rescheduled, favorite).
There is no contacts write route on this API — campaign membership is tag-defined, so contacts are added by tagging them in Contacts.
Authorizations
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
Dialer campaign ID.
^[1-9][0-9]*$Query Parameters
Opaque cursor taken from meta.nextCursor of a previous page. A cursor that cannot be decoded is ignored and the list restarts from the first page — it does not error.
Maximum number of contacts per page.
1 <= x <= 100Narrow to one or more queue positions. Repeat the parameter (?queueTag=fresh&queueTag=retry) or comma-separate (?queueTag=fresh,retry). An unknown value is a 400.
assigned, scheduled, completed, dnc, exhausted, excluded, fresh, retry, rescheduled, favorite Case-insensitive substring match over the contact's display name and phone numbers. At most 200 characters.
200