---
title: "Poll export status"
method: GET
path: "/api/v1/contacts/search/export/{exportId}"
tags: ["Search"]
---

# Poll export status

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

## Request

- Base URL: `https://app.getleads.io`
- URL: `https://app.getleads.io/api/v1/contacts/search/export/{exportId}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Poll until `job_status` is `completed` or `failed`.

## Path parameters

- `exportId` string, required

## Response `200`

Export status

- object
  - `ok` boolean
  - `export_id` string
  - `job_status` 'queued' | 'running' | 'completed' | 'failed'
  - `rows_available` integer
  - `rows_capped_by_credits` boolean
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `export_url` string, uri: Pre-signed download URL (completed only).
  - `expires_in_seconds` integer
  - `rows_exported` integer
  - `query_credits_used` integer
  - `creditsRemaining` integer, nullable
  - `max_rows` integer
  - `max_per_company` integer
  - `cap_reason` string
  - `cap_message` string
  - `error` string
  - `message` string

## Other responses

- `401`: Missing or invalid API key
- `404`: Resource not found

---

[API](https://skmtc.dev/getleads/apis/getleads-api.md) - [All operations](https://skmtc.dev/getleads/apis/getleads-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getleads/apis/getleads-api/revisions/f5dbc32e0c3a?raw)