---
title: "Get campaign lead statuses"
method: GET
path: "/api/v4/campaigns/{campaign_id}/lead_statuses"
tags: ["Campaigns"]
---

# Get campaign lead statuses

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

## Request

- Base URL: `https://{cluster_id}.voiso.com`
- URL: `https://{cluster_id}.voiso.com/api/v4/campaigns/{campaign_id}/lead_statuses`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/voiso/apis/voiso-api/docs/api/v4/campaigns/:campaign_id/lead_statuses/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns status information for campaign leads.

## Path parameters

- `campaign_id` integer, required

## Query parameters

- `phone_number` union, required
  - string, phone
  - string[]

## Response `200`

OK

- object
  - `lead_statuses` LeadStatus[]: Lead statuses.
    - `campaign_id` integer: The unique identifier of the campaign.
    - `campaign_lead_id` integer: The unique identifier of the campaign lead. The same value is returned as `campaign_lead_id` in the CDR API and the dialer call event webhooks.
    - `phone_number` string, phone: The phone number of the lead.
    - `dialed` boolean: Whether the lead has been dialed.
    - `last_call` LeadLastCall, nullable: Last call information.
      - `id` string, uuid: The unique identifier of the call.
      - `started_at` string, date-time: When the call started.
      - `disposition` 'busy' | 'answered' | 'vm_answered' | 'machine_answered' | 'abandoned' | 'dialer_abandoned' | 'system_abandoned' | 'rejected' | 'system_rejected' | 'no_answer' | 'missed' | 'failed': Call disposition.
      - `wrapup_code` WrapupCodeSnapshot: Wrap-up code snapshot.
        - `code_snapshot` string: Wrap-up code value.
    - `redial` LeadRedial, nullable: Redial information.
      - `scheduled` boolean: Whether another redial attempt is scheduled. Always false for a deactivated campaign lead.
      - `scheduled_at` string, date-time, nullable: Date and time of the next scheduled redial attempt.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `429`: Too many requests

## Changes

- **2026-11-03** `5a6ea146bd21`: 1 info
  - added the optional property `lead_statuses/items/campaign_lead_id` to the response with the `200` status

[Operation history](https://skmtc.dev/voiso/apis/voiso-api/changes/api/v4/campaigns/:campaign_id/lead_statuses/get.md)

---

[API](https://skmtc.dev/voiso/apis/voiso-api.md) - [All operations](https://skmtc.dev/voiso/apis/voiso-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voiso/apis/voiso-api/revisions/5a6ea146bd21?raw)