POST list_leads
Leads matched to your services and locations, newest first, with credit cost and signals.
read
Returns the leads Bark matched to your services and locations, newest first by default. Each item has the credit cost and signals such as urgent, so you can decide before you spend anything. Reading a list spends no credits and notifies no customer.
POST /api/v1/bark/list_leads
Input
| Parameter | Type | Description |
|---|---|---|
| view | enum | all, first_to_respond, urgent or free. Default: all. |
| service | string | Only this service, e.g. Web Design. |
| max_credits | integer | Skip leads that cost more credits. |
| since | date | Only leads submitted on or after this date. |
| sort | enum | relevance, date or credits. Default: date. |
| limit | integer | 1 to 50. Default: 20. |
Example response
{
"leads": [
{
"lead_id": "61842207",
"service": "Wedding Photography",
"location": "Leeds, LS1",
"credits": 12,
"signals": [
"urgent"
],
"submitted": "2026-10-11"
},
{
"lead_id": "61841930",
"service": "Web Design",
"location": "Manchester, M1",
"credits": 9,
"signals": [
"first_to_respond"
],
"submitted": "2026-10-11"
}
]
}