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.
Authorization
BearerAuth read:leadsAuthorizationBearer <token>
In: header
Scope: read:leads
Path Parameters
id*string
Query Parameters
limit?integer
offset?integer
email?string
startDate?string
endDate?string
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"{
"items": [
{
"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"
}
],
"total": 0,
"limit": 0,
"offset": 0
}{
"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"
}
]
}