---
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`

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.
    - `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.
      - `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

---

[API](https://skmtc.net/voiso/apis/voiso-api.md) · [All operations](https://skmtc.net/voiso/apis/voiso-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voiso/voiso-api/revisions/3d34cfd8f064/schema)
