---
title: "Get An Outbound Campaign Lead"
method: GET
path: "/v1/convai/outbound-campaigns/campaigns/{campaign_id}/leads/{lead_id}"
tags: ["Agents Platform"]
---

# Get An Outbound Campaign Lead

`GET /v1/convai/outbound-campaigns/campaigns/{campaign_id}/leads/{lead_id}`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/convai/outbound-campaigns/campaigns/{campaign_id}/leads/{lead_id}`
- Auth: none declared

Get one lead of an outbound campaign.

## Path parameters

- `campaign_id` string, required
- `lead_id` string, required

## Headers

- `xi-api-key` string, nullable: Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- LeadDetailResponse
  - `lead_id` string, required
  - `recipient_id` string, nullable, required: The `id` given to this recipient when the campaign was created.
  - `phone_number` string, required: The number the lead's next call dials. It changes when the lead moves on to another listed number or the contact asks to be called on a different one.
  - `phone_numbers` string[]: The lead's listed numbers, in calling order.
  - `phone_numbers_index` integer, required: The position in `phone_numbers` of the number being called.
  - `user_id` string, required: The contact's identity: the `user_id` submitted in `conversation_initiation_client_data`, else the lead's phone number.
  - `attempt_count` integer, required: Calls placed, counted against the policy's `max_total_calls`.
  - `failure_count` integer, required: Failed calls to the current number; resets on a new number.
  - `callback_count` integer, required: Callbacks the contact asked for.
  - `redirect_count` integer, required: Times the contact asked to be called on another number.
  - `do_not_call` boolean, required: Set when the contact asked not to be called, the lead was removed, or the campaign stopped. The lead isn't called again.
  - `terminal_disposition` 'campaign_ended' | 'removed' | 'do_not_call' | 'completed' | 'cancelled' | 'suppressed' | 'attempt_ceiling_reached' | 'callback_ceiling_reached' | 'redirect_ceiling_reached' | 'permission_not_granted' | 'permission_declined' | 'permission_request_blocked' | 'permission_expired' | 'callback_time_invalid' | 'redirect_number_invalid' | 'couldnt_process', required
  - `created_at_unix` integer, nullable, required: When the lead joined the campaign; unset on older leads.
  - `updated_at_unix` integer, required
  - `dynamic_variables` object, required: The dynamic variables submitted for the lead, with secrets redacted.
  - `overrides` FlattenedConfigOverrides, required
    - `language` string, nullable
    - `first_message` string, nullable
    - `prompt` string, nullable
    - `voice_id` string, nullable
  - `delivery` LeadDeliveryView
    - `status` 'pending' | 'dispatched' | 'initiated' | 'in_progress' | 'completed' | 'failed' | 'cancelled' | 'voicemail', required
    - `stage` 'queued' | 'sent' | 'delivered' | 'read' | 'replied' | 'failed', required: The furthest the message got, or `failed` if sending it failed.
    - `sent_at_unix` integer, nullable, required
    - `delivered_at_unix` integer, nullable, required
    - `read_at_unix` integer, nullable, required
    - `replied_at_unix` integer, nullable, required
    - `failed_at_unix` integer, nullable, required
    - `error_message` string, nullable, required: Why the message failed to reach the contact.

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-10** `49e0431bea4c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/outbound-campaigns/campaigns/:campaign_id/leads/:lead_id/get.md)

---

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