Read one captured lead: contact details, captured form fields, and the conversation it came from. Never returns network data. Requires the read:leads permission.
Authorization
BearerAuth read:leadsIn: header
Scope: read:leads
Path Parameters
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/agents/string/leads/1"{
"id": 314,
"agentId": "a1b2c3d4e5",
"conversationId": "sess_9f8e7d",
"name": "Ada Lovelace",
"email": "[email protected]",
"phone": null,
"city": "London",
"country": "United Kingdom",
"countryCode": "GB",
"fields": {
"company": "Analytical Engines Ltd"
},
"capturedAt": "2026-08-01T10:05:00.000Z"
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"issues": [
{
"path": "string",
"message": "string"
}
]
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"issues": [
{
"path": "string",
"message": "string"
}
]
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"issues": [
{
"path": "string",
"message": "string"
}
]
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"issues": [
{
"path": "string",
"message": "string"
}
]
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"issues": [
{
"path": "string",
"message": "string"
}
]
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"issues": [
{
"path": "string",
"message": "string"
}
]
}List leads GET
List leads the agent captured, newest first, paged with `limit`/`offset` and filterable by `email` substring and `startDate`/`endDate` (inclusive, YYYY-MM-DD). Includes contact details and captured form fields, never network data. Requires the `read:leads` permission.
Get account usage GET
Plan, message credits used against the monthly allowance, subscription status, and days until the period resets. Requires the `read:usage` permission.