Webhooks
A search ended
Sent when a search you started with POST /v1/search has ended. Read its rows with GET /v1/search/{id} when data.status is complete; when it is failed, submit the search again.
WEBHOOK
search.completed
{
"type": "search.completed",
"timestamp": "2026-10-10T13:20:39.606Z",
"data": {
"search_id": "e8413914-cea8-46b0-9c6b-8207a4157fc0",
"status": "complete",
"end_customer_id": null
}
}Headers
The event id, the same on every attempt: use it to ignore a repeat.
When this attempt was sent, in seconds since 1970-01-01 UTC. Reject an old one.
The Standard Webhooks signature of this attempt, made with your endpoint's secret. Check it before trusting the body.
Body
application/json
Response
2XX
Received. Answer within 15 seconds; any other answer, or none, is retried over about three days.
Was this page helpful?
⌘I
{
"type": "search.completed",
"timestamp": "2026-10-10T13:20:39.606Z",
"data": {
"search_id": "e8413914-cea8-46b0-9c6b-8207a4157fc0",
"status": "complete",
"end_customer_id": null
}
}