---
title: "Poll an export job"
method: GET
path: "/exports/{id}"
tags: ["Exports"]
---

# Poll an export job

`GET /exports/{id}`

## Request

- Base URL: `https://codeatlas.com.br/api/v1`
- URL: `https://codeatlas.com.br/api/v1/exports/{id}`
- Auth: OAuth 2 (client credentials, token URL `https://codeatlas.com.br/oauth2/token`, scopes: `api:write`)

Returns the job status: queued, running or succeeded. When succeeded, data.download_url points to the file. Only the OAuth client that created the job can read it; any other client gets 404.

## Path parameters

- `id` string, required

## Response `200`

Current job state.

- ExportResponse
  - `data` object, required
    - `id` string, required
    - `status` 'queued' | 'running' | 'succeeded', required
    - `format` 'jsonl' | 'csv' | 'md', required
    - `download_url` string, uri, nullable, required: Set when status is succeeded.
    - `created_at` string, date-time, required
    - `expires_at` string, date-time, required

## Other responses

- `401`: Missing, malformed, expired or wrong-audience Bearer token. WWW-Authenticate carries the resource metadata URL.
- `403`: The token lacks the api:write scope.
- `404`: The resource does not exist or is not visible to this client.
- `405`: The HTTP method is not supported.
- `429`: Rate limit exceeded. Wait Retry-After seconds.
- `default`: Unexpected error. Same shape as every other error.

---

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