Skip to main content
GET
/
campaigns
/
{id}
/
contacts
cURL
curl --request GET \
  --url https://api.altur.io/api/v1.0/campaigns/{id}/contacts \
  --header 'Authorization: <api-key>'
{
  "total_count": 123,
  "contacts": [
    {
      "f_id": "<string>",
      "id": 123,
      "name": "<string>",
      "contact": "<string>",
      "status": "<string>",
      "context": "<string>",
      "retries": 123,
      "has_follow_up": true,
      "call_count": 123,
      "billed_duration": 270,
      "last_call_at": "2025-10-03 19:11:39",
      "extracted_data": {
        "monto_prometido": "1000",
        "fecha_limite": "01-01-2025"
      },
      "tags": [
        "tag1",
        "tag2"
      ]
    }
  ],
  "pagination": {
    "has_next": true,
    "has_previous": true,
    "next_page": 123,
    "previous_page": 123
  }
}
Rate Limit: 12 requests per second

​
Status Values by Campaign Type

  • queue — Contact is waiting in queue
  • sending — Call is being initiated
  • failed — Call failed to connect
  • retrying — Scheduled for retry
  • converted — Contact was converted
  • voicemail — Reached voicemail
  • answered — Call was answered

Authorizations

​
Authorization
string
header
required

Add api-key YOUR_API_SECRET_KEY as the value of the Authorization header.

Path Parameters

​
id
integer
required

The identifier of the Campaign to return the Contacts

Query Parameters

​
status
enum<string>

Filters the Campaign Contacts by the Status of the Campaign Contact

Available options:
queue,
sending,
sent,
delivered,
voicemail,
read,
failed,
retrying,
converted,
answered,
accepted,
rejected
​
pageSize
integer
default:50

Number of items per page to return.

Required range: 1 <= x <= 100
​
pageIndex
integer
default:0

Page number to the next page to return.

Required range: 0 <= x <= 25000

Response

Campaign Contacts response

​
total_count
integer

Total number of Campaign Contacts for the given query. NOTE: Only calculated in the first page.

​
contacts
object[]
​
pagination
object

Filters are applied to each request independently. Changing filters while paginating may result in gaps or overlaps in the result set. For consistent results, maintain the same filters throughout pagination.