Skip to main content
GET
List surveys
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).

Query Parameters

cursor
string

Opaque cursor taken from meta.nextCursor of a previous page. Pass it back unchanged. Omitting cursor, or sending it empty, starts from the first page — neither is an error. A non-empty cursor this endpoint cannot decode is rejected with 400 and code: "PAGINATION.INVALID_CURSOR" rather than silently restarting the list. Handle it as an error, not as a terminating null cursor: a loop that only stops on null would re-send the same rejected cursor. Drop the stored cursor and restart from a checkpoint you control.

limit
integer
default:50

Maximum number of items per page.

Required range: 1 <= x <= 100
include_archived
boolean
default:false

Set to true to include archived items. Only the literal strings true and false are accepted — anything else is a 400.

Response

One page of survey summaries.

One cursor page of survey summaries.

data
object[]
meta
object

Cursor-pagination metadata.