Database search

Check an export

Poll export status from POST /api/v1/contacts/search/export. While job_status is queued or running, retry every few seconds. When completed, the response includes a presigned export_url (valid 24 hours).

GET/api/v1/contacts/search/export/{export_id}

Authorization

Header	Type	Required	Description
`X-API-Key`	string	required	Your API key, for example `lb_live_YOUR_API_KEY`. You can send the same key as `Authorization: Bearer` instead.

Path parameters

Name	Type	Required	Default	Description
`export_id`	string	required		The export id of the record you want.

Response

ok boolean: True when the request succeeded.
export_id string: The identifier of the export job.
job_status string: One of queued, running, completed or failed.
export_url string: A signed CSV download link, valid for 24 hours.
expires_in_seconds number: How long the download link stays valid.
rows_exported number: The number of rows written to the CSV.
rows_available number: The number of rows that matched the filters.
rows_capped_by_credits boolean: True when the credit balance limited the export.
query_credits_used number: Plan credits this request spent.
creditsRemaining number: Plan credits left after this request. Null on unlimited plans.

curl -sS "https://leadmcp.ai/api/v1/contacts/search/export/01KV8DNW282Y2V5YAQ51C2XWN1" \
  -H "X-API-Key: lb_live_YOUR_API_KEY"

Response200

{
  "ok": true,
  "export_id": "01KV8DNW282Y2V5YAQ51C2XWN1",
  "job_status": "completed",
  "export_url": "https://...",
  "expires_in_seconds": 86400,
  "rows_exported": 46169,
  "rows_available": 46169,
  "rows_capped_by_credits": false,
  "query_credits_used": 46169,
  "creditsRemaining": 1234
}