---
title: "Download converted document"
method: GET
path: "/documents/{id}/export/{format}"
tags: ["Exports"]
---

# Download converted document

`GET /documents/{id}/export/{format}`

## Request

- Base URL: `https://api.bankstatemently.com/v1`
- URL: `https://api.bankstatemently.com/v1/documents/{id}/export/{format}`
- Auth: API key in header `X-API-Key`

Download the processed document in the specified format. The document must have status `completed`. Rate limit: 30 requests per minute.

## Path parameters

- `id` string, uuid, required
- `format` 'json' | 'csv' | 'xlsx' | 'qbo' | 'xero', required: Supported export formats.

## Query parameters

- `dataMode` 'original' | 'enhanced' | 'normalized': The data mode to export. `original` returns raw extracted data; `enhanced` (default) includes AI-enriched fields; `normalized` applies standardized formatting.
- `dateFormat` 'DD/MM/YYYY' | 'MM/DD/YYYY' | 'YYYY/MM/DD'

## Response `200`

The exported file. Content-Type varies by format.

- object: Structured JSON export of the document.

## Other responses

- `400`: Invalid request parameters (e.g., invalid dataMode).
- `401`: Authentication failed, API key revoked, or API key expired.
- `404`: Document or completed processing run not found.
- `409`: Document processing not yet completed.
- `422`: Export generation failed.
- `429`: Too many requests. Wait the number of seconds indicated by the `Retry-After` header.
- `500`: An unexpected server error occurred.

---

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