Create statement export (async)

Queues an asynchronous export of the account statement for the given date range (`format`: `csv`, `pdf`, or `xlsx`). Poll `GET /v1/accounts/{accountId}/exports` until status is `COMPLETED`, then download via `GET /v1/accounts/{accountId}/exports/{exportId}/download`. The file contains **live** statement rows from the banking partner (ISPB `50871921`). Columns match the statement, plus `ispb`. The last column is `pixKey` — the same field as on each statement item (incoming key on a credit; destination key on a debit). Empty outside PIX and on older rows. Saldo após transação (`balance`) is **not** included. CSV and XLSX use the requested date range in full (no row cap). PDF still clamps dates to 21/05/2026 … 24h ago, but no longer truncates at 10,000 rows. XLSX continues on extra sheets (`Statement_2`, …) if a single Excel sheet fills.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accountIdstringRequired
Account identifier.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
Idempotency-KeystringOptional

Optional client-generated idempotency token (recommended for safe retries).

X-Request-TimestampstringRequired

Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).

X-Content-SHA256stringRequired

Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.

X-Request-SignaturestringRequired

Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.

Request

This endpoint expects an object.
typeenumRequired

Export type. Only statement is supported.

startDatedateRequired

Inclusive start date (YYYY-MM-DD).

endDatedateRequired

Inclusive end date (YYYY-MM-DD).

formatenumOptionalDefaults to csv

File format. csv and xlsx share the same columns. pdf is a formatted statement (date window still clamped).

Response

Export job accepted.
exportIdstring
accountIdstring
tenantIdstring
typestring
statusenum
createdAtdatetime
formatenumOptional
paramsmap from strings to anyOptional
rowCountintegerOptional
errorReasonstringOptional
completedAtdatetimeOptional

Errors

400
Bad Request Error
403
Forbidden Error
500
Internal Server Error