---
title: "Get Export"
method: GET
path: "/exports/{export_id}"
tags: ["Exports"]
---

# Get Export

`GET /exports/{export_id}`

## Request

- Base URL: `https://api.burodeingresos.com`
- URL: `https://api.burodeingresos.com/exports/{export_id}`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api/docs/exports/:export_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the state of an export and, once completed, one signed download link per file.

Each `url` is valid for about **1 hour** and is re-issued fresh on every read, so if a link expires, call this endpoint again. The export itself is available for **7 days** after completion; after that the files are purged and `files` comes back empty.

## Path parameters

- `export_id` string, uuid, required

## Response `200`

Export state, with download links while completed and not expired.

- ExportResponse
  - `export_id` string, uuid
  - `bulk_id` string, uuid
  - `estimates` object: Present only when `estimates` was requested. The options `estimates.csv` is computed with, defaults included.
    - `window_months` integer
    - `sources` string
    - `as_of` string, date
    - `history` boolean
  - `status` 'queued' | 'processing' | 'completed' | 'failed' | 'expired'
  - `requested_at` string, date-time
  - `finished_at` string, date-time
  - `expires_at` string, date-time: The export is available for 7 days after completion. After this moment the files are purged.
  - `error_code` string: Present only when status is failed.
  - `error_message` string: Present only when status is failed.
  - `files` ExportFile[]: Empty until the export completes, and empty again once it expires.
    - `name` string
    - `rows` integer
    - `bytes` integer
    - `url` string: Signed download link, valid for about 1 hour. Re-issued fresh on every read of GET /exports/{export_id}. Only present while the export is completed and not expired.
    - `expires_at` string, date-time: Expiration of this download link.

## Other responses

- `404`: The export_id does not exist on your account.

## Changes

- **2026-11-03** `98eb3984cffb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api/changes/exports/:export_id/get.md)

---

[API](https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api.md) - [All operations](https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api/llms.txt) - [OpenAPI document](https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api/revisions/98eb3984cffb?raw)