Skip to main content
GET
/
v1
/
campaigns
/
{campaignId}
/
leads
Get Campaign Leads
curl --request GET \
  --url https://app-api.walead.ai/api/v1/campaigns/{campaignId}/leads \
  --header 'x-api-key: <api-key>'
{
  "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"
      }
    }
  ]
}

​
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

Authorizations

​
x-api-key
string
header
required

API key for authentication. Generate from your WaLead dashboard.

Path Parameters

​
campaignId
string
required

Campaign ID

Response

Leads retrieved successfully

​
campaignId
string

Campaign ID

​
total
integer

Total number of leads in the campaign

​
leads
object[]