> ## Documentation Index
> Fetch the complete documentation index at: https://docs.walead.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Campaign Leads

> Retrieves all leads associated with a specific campaign

## Overview

Retrieves all leads associated with a specific campaign. This endpoint returns detailed information about each lead, including their status, LinkedIn profile data, and campaign progress.

## Response Structure

The response includes:

* **campaignId**: The campaign identifier
* **total**: Total number of leads in the campaign
* **leads**: Array of lead objects with complete information

Each lead object includes:

* **Profile Information**: Name, LinkedIn URL, email, phone, company
* **Status Fields**: Current status and internal processing status
* **Campaign Progress**: Current step in the sequence
* **Custom Variables**: Additional data collected for personalization

## Use Cases

* Monitor campaign progress and lead statuses
* Export campaign leads for analysis
* Track which leads have been contacted
* Identify leads requiring follow-up


## OpenAPI

````yaml GET /v1/campaigns/{campaignId}/leads
openapi: 3.1.0
info:
  title: WaLead API
  description: >-
    WaLead Public API for managing LinkedIn outreach campaigns, leads, and
    analytics
  version: 1.0.0
  contact:
    name: WaLead Support
    url: https://walead.ai
servers:
  - url: https://app-api.walead.ai/api
    description: Production server
security:
  - apiKeyAuth: []
paths:
  /v1/campaigns/{campaignId}/leads:
    get:
      summary: Get Campaign Leads
      description: Retrieves all leads associated with a specific campaign
      parameters:
        - name: campaignId
          in: path
          description: Campaign ID
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Leads retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  campaignId:
                    type: string
                    description: Campaign ID
                  total:
                    type: integer
                    description: Total number of leads in the campaign
                  leads:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        publicIdentifier:
                          type: string
                        linkedinUrl:
                          type: string
                        entityUrn:
                          type: string
                          nullable: true
                        firstName:
                          type: string
                        lastName:
                          type: string
                        name:
                          type: string
                        email:
                          type: string
                        phone:
                          type: string
                        companyName:
                          type: string
                        headline:
                          type: string
                        website:
                          type: string
                        summary:
                          type: string
                        profilePictureUrl:
                          type: string
                        status:
                          type: string
                        internalStatus:
                          type: string
                        currentStep:
                          type: integer
                        customVariables:
                          type: object
              example:
                campaignId: abc123-def456-ghi789
                total: 150
                leads:
                  - id: lead-uuid-123
                    publicIdentifier: john-doe-12345
                    linkedinUrl: https://www.linkedin.com/in/john-doe-12345
                    entityUrn: null
                    firstName: John
                    lastName: Doe
                    name: John Doe
                    email: john.doe@example.com
                    phone: '+1234567890'
                    companyName: Example Corp
                    headline: CEO at Example Corp
                    website: https://example.com
                    summary: Experienced executive with a passion for innovation...
                    profilePictureUrl: https://media.licdn.com/dms/image/...
                    status: verified
                    internalStatus: waiting
                    currentStep: 0
                    customVariables:
                      city: San Francisco
                      state: California
                      jobTitle: Chief Executive Officer
                      location: San Francisco, California
        '401':
          description: Unauthorized - Invalid API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Campaign not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      required:
        - statusCode
        - message
      properties:
        statusCode:
          type: integer
          description: HTTP status code
        message:
          type: string
          description: Error message
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Generate from your WaLead dashboard.

````