Leads

List Leads

GET /v1/leads?campaignId=camp_abc123
GET /v1/leads?brandId=brand_abc123
X-API-Key: dist_YOUR_KEY

Filter by campaign or brand. Returns contact details, company info, and outreach status.

{
  "leads": [
    {
      "id": "lead_abc",
      "firstName": "Jane",
      "lastName": "Doe",
      "email": "jane@company.com",
      "title": "CTO",
      "organizationName": "Company Inc",
      "organizationDomain": "company.com",
      "organizationIndustry": "Software",
      "organizationSize": "50-200",
      "linkedinUrl": "https://linkedin.com/in/janedoe",
      "status": "contacted",
      "contacted": true,
      "delivered": true,
      "bounced": false,
      "replied": true,
      "createdAt": "2026-04-01T00:00:00Z"
    }
  ]
}

TypeScript Client

const { leads } = await client.listLeads({ campaignId: "camp_abc123" });
const { leads: brandLeads } = await client.listLeads({ brandId: "brand_abc" });