Skip to main content
GET
/
api
/
v2
/
leads
List leads
curl --request GET \
  --url https://api.example.com/api/v2/leads
Returns leads across every campaign owned by the user. Useful for Zapier-style polling. For campaign-scoped extraction use GET /api/v2/streams//leads.

​
Query parameters

NameTypeDescription
streamIdnumberScope to one campaign
segmentIdnumberScope to one segment
accountIdnumberScope to one source account
lifecycleenum"new" or "exported"
sinceISO 8601Leads discovered after this timestamp
groupByenum"stream" returns {groups: [{streamId, streamName, leads: [...]}]} instead of a flat array

​
Response (flat)

{
  "data": [
    {
      "id": 1234,
      "trackedAccount": { "id": 7, "xHandle": "yongfook" },
      "profile": { "xUserId": "...", "handle": "alice", "displayName": "..." },
      "matchConfidence": "high",
      "sourceType": "new_follower",
      "discoveredAt": "2026-06-02T09:01:00Z"
    }
  ]
}

​
Auth

Bearer API key.