Skip to main content
GET
Export card transactions
The file has one row per DEBIT or CREDIT transaction of the period, newest first, with the columns Data da transação (Brasília time), Razão social and Nome fantasia (the account’s company), Tipo, Valor (in reais, 1.234,56), Descrição and Cartão (the masked card number). Narrow it with startDate and endDate (both, or neither), merchantName and financialImpactType, like the transaction list; up to 10,000 transactions fit in one file. type=csv returns the text, type=xlsx the workbook encoded in base64 — decode it before saving. Use default as walletId for the organization’s main wallet, and send x-environment: LIVE for a production card. Any member of the organization can export a card’s transactions.

Headers

x-environment
enum<string>

Environment of the card: LIVE (production) or TEST (sandbox). When you omit it, the request runs in TEST; any other value is rejected.

Available options:
LIVE,
TEST

Path Parameters

realmId
string<uuid>
required

ID of your realm.

Format: UUID

organizationId
string<uuid>
required

ID of the organization the card belongs to.

Format: UUID

accountId
string
required

ID of the organization's account (24 hexadecimal characters).

Pattern: ^[0-9a-fA-F]{24}$
walletId
string
required

ID of the card's wallet (24 hexadecimal characters), or default for the organization's main wallet.

Pattern: ^([0-9a-fA-F]{24}|default)$
cardId
string
required

ID of the card (24 hexadecimal characters).

Pattern: ^[0-9a-fA-F]{24}$

Query Parameters

type
enum<string>
required

File format: csv (comma-separated text) or xlsx (an Excel workbook, returned base64-encoded).

Available options:
csv,
xlsx
startDate
string

Start of the period, inclusive: an ISO 8601 date-time (2026-11-01T03:00:00.000Z) or date (2026-11-01, read as midnight UTC). The period applies only when you send both startDate and endDate.

endDate
string

End of the period, inclusive, in the same format as startDate.

merchantName
string

Only transactions whose merchant name contains this text (case-insensitive).

Maximum string length: 256
financialImpactType
string[]

Only transactions with these effects on the balance (case-insensitive): DEBIT (money out), CREDIT (money in) or NONE (no effect, such as a declined authorization). Other values match no transaction.


Example (comma-separated list): ?financialImpactType=DEBIT,CREDIT

Maximum string length: 64

Response

application/csv — CSV text, UTF-8 with a byte-order mark, one header row.

application/vnd.openxmlformats-officedocument.spreadsheetml.sheet — The Excel workbook, base64-encoded.

CSV text, UTF-8 with a byte-order mark, one header row.