> ## Documentation index
> Fetch the complete documentation index at: https://leadmcp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Check an export

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

Authentication: API key.

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).

### Path parameters

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

### Response fields

| Field | Type | Description |
| --- | --- | --- |
| `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. |

### Example request

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

### Example response (200)

```json
{
  "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
}
```