Get Campaign Contacts
Retrieve all contacts in a campaign with their current status and assignment details. For non-admin users, only threads assigned to them are returned.
Endpoint
GET /v1/campaigns/{campaign_id}/contacts
Authentication
Path Parameters
Query Parameters
The current user’s unique_id. Used for filtering threads by assignment when is_admin is false.
If true, returns all contacts in the campaign. If false, only returns contacts assigned to the specified user_id.
Response
Whether the request was successful
Array of contact objects
Thread identifier (format: {phone_number}_{campaign_id})
"true" if the contact has replied to any message, "false" otherwise
ISO 8601 timestamp of the most recent message in the thread
Current drip sequence step (0-based)
Lead qualification status. Values: "qualified", "not_interested", "dnc", or empty
"true" if the campaign objective was met for this contact
The unique_id of the user this thread is assigned to (empty if unassigned)
Display name of the assigned user (empty if unassigned)
ISO 8601 timestamp of when the thread was assigned (empty if unassigned)
Total number of contacts returned
Example Request
curl "https://partner.teli.ai/api/proxy/v1/campaigns/camp_abc123/contacts?user_id=admin_001&is_admin=true" \
-H "X-API-Key: YOUR_API_KEY"
Example Response
{
"success": true,
"contacts": [
{
"thread_id": "+15551234567_camp_abc123",
"phone_number": "+15551234567",
"first_name": "Anthony",
"last_name": "Toma",
"email": "anthony@example.com",
"has_ever_responded": "true",
"last_message_timestamp": "2026-02-19T17:29:00Z",
"drip_step_index": 0,
"lead_outcome": "qualified",
"objective_met": "true",
"assigned_user_id": "user_xyz789",
"assigned_user_name": "Tao Zhang",
"assigned_at": "2026-02-20T23:07:28Z"
}
],
"total": 1,
"powered_by": "Teli"
}
Filtering Behavior
| Caller | is_admin | Result |
|---|
| Admin | true | All contacts in the campaign |
| User | false | Only contacts assigned to user_id |
| User (no assignments) | false | Empty array |
