The Get campaign lead statuses endpoint returns dialing status information for one or more phone numbers in a specific campaign.

Requirements: Base URL, Authentication, Error codes

What this does

When you send a request with a campaign ID and one or more phone numbers,

Endpoint

GET /api/v4/campaigns/{campaign_id}/lead_statuses

Path parameters

• campaign_id
  The unique identifier of the campaign.

Query parameters

• phone_number
  Required. One phone number, or multiple values using array syntax. Maximum 100 values.

Related endpoints

• Get a campaign ID: Get list of campaigns
• Add leads: Add leads to a campaign
• Update leads: Update campaign leads

Example requests

Single phone number:

curl -X GET "https://{cluster_id}.voiso.com/api/v4/campaigns/3/lead_statuses?phone_number=15551234567" \
  -H "Authorization: Bearer <contact_center_api_key>" \
  -H "Content-Type: application/json"

Multiple phone numbers:

curl -X GET "https://{cluster_id}.voiso.com/api/v4/campaigns/3/lead_statuses?phone_number[]=15551234567&phone_number[]=15557654321" \
  -H "Authorization: Bearer <contact_center_api_key>" \
  -H "Content-Type: application/json"

Response

If successful, the API returns a lead_statuses array.

{
  "lead_statuses": [
    {
      "campaign_id": 3,
      "phone_number": "15551234567",
      "dialed": true,
      "last_call": {
        "id": "7d7f8c74-da08-4eb3-b779-41364c129d8a"
      },
      "redial": {
        "enabled": true,
        "at": "2026-05-06T10:15:00Z"
      }
    }
  ]
}

Notes

• phone_number supports up to 100 values per request.
• A lead may have dialed: false even if it exists in the campaign (for example, newly imported leads).

Troubleshooting

400 Bad request

Common causes:

• Missing phone_number query parameter.
• More than 100 phone_number values were provided.

401 Unauthorized

Returned if the API key is missing or invalid.

403 Forbidden

Returned if the API key does not have access to Campaigns resources.

404 Not found

Returned if the campaign does not exist or is not accessible.

422 Unprocessable Entity

Returned if one or more query parameter values are invalid.

429 Too many requests

Returned if requests are rate limited.