Skip to main content
GET
Download Card Statement

Overview

Generate a PDF statement for a card. The statement is branded with your company name and includes a cardholder information panel, card details, and the card’s transaction history for the requested period. The endpoint returns the PDF directly in the response body (Content-Type: application/pdf, Content-Disposition: attachment) with HTTP 200. Save the response bytes to a file.

Endpoint

Scope required: cards:read

Path Parameters

Query Parameters

Response

Responds with HTTP 200 and the PDF file itself in the body (Content-Type: application/pdf, Content-Disposition: attachment; filename="statement_<scheme>_<name>_<cardId>.pdf"). Write the response bytes straight to a file.

Statement Contents

The generated PDF includes:
  • Header — your business name and a “CARD STATEMENT” label on a branded band
  • Statement Period — the from–to date range covered
  • Cardholder Information — cardholder name and billing address
  • Card Details — masked card number, card brand, card status, currency
  • Transaction History — a table of transactions in the period with Date, Description, Debit (USD) and Credit (USD) columns
  • Footer — an automated-statement disclaimer

Example Usage

Error Responses

Card Not Found (404)

Card Still Provisioning (202)

The statement uses your business branding from Business Settings (logo, colors, company name and address). Make sure to configure your branding for a professional white-labeled statement.
If no date range is specified, the statement covers the entire card lifetime from creation date to today.

Authorizations

Authorization
string
header
required

JWT access token obtained from /auth/token

Path Parameters

cardId
string
required

Card ID

Query Parameters

from
string<date>

Start date (YYYY-MM-DD). Defaults to card creation date.

Example:

"2026-03-01"

to
string<date>

End date (YYYY-MM-DD). Defaults to today.

Example:

"2026-03-31"

Response

PDF statement file

The response is of type file.