GET
/
campaigns
/
{campaignId}
/
contacts
Get all contacts by campaign ID
curl --request GET \
  --url https://api.callers.ai/campaigns/{campaignId}/contacts \
  --header 'Authorization: <api-key>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "phoneNumber": "<string>",
    "campaignId": "<string>",
    "status": "<string>",
    "attempts": 123,
    "failedReason": "<string>",
    "failedReasonDetails": "<string>",
    "createdAt": "<string>",
    "lastAttempt": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

Headers

​
x-sub-organization-id
string

Optional sub organization ID. Must belong to your main organization API key.

Path Parameters

​
campaignId
string
required

Id of the campaign as a string ObjectId value.

Query Parameters

​
lastAttemptTo
string

Filter contacts up to this last attempt date in ISO 8601 UTC format (e.g. YYYY-MM-DDTHH:mm:ss.sssZ). Default is null.

​
lastAttemptFrom
string

Filter contacts from this last attempt date in ISO 8601 UTC format (e.g. YYYY-MM-DDTHH:mm:ss.sssZ). Default is null.

​
archived
boolean

Archived filter. Default is false.

​
sortDirection
string

Sorting direction. Default is ascending. Possible values: 'asc' or 'desc'.

​
sortAttribute
string

Sorting attribute. Name of the entity field to sort by.

​
statuses
string

Status filter. Default is all statuses.

​
perPage
number

Max page size. Default is 50.

​
page
number

Page number. Default is 0.

Response

default - application/json

The response is of type object[].