---
title: "Poll a candle export"
method: GET
path: "/v1/candles/export/{exportId}"
---

# Poll a candle export

`GET /v1/candles/export/{exportId}`

## Request

- Base URL: `https://app.texttoquant.com/api`
- URL: `https://app.texttoquant.com/api/v1/candles/export/{exportId}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

status queued | running (progress: fetched_bars, expected_bars, percent; retryAfterSeconds) | done (the file fields and a link signed afresh on every poll) | failed (error: { code, message, retryable, retryAfter? }, e.g. symbol_not_found, market_data_busy, export_timeout) | cancelled. Exports are kept a day; another account's id answers 404.

## Path parameters

- `exportId` string, required

## Response `200`

Success

- object
  - `success` true, required
  - `data` object, required

## Other responses

- `400`: invalid_query: not an export id
- `403`: Plan does not include marketData
- `404`: export_not_found
- `500`: internal_error: the export could not be read; retryable

---

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