Skip to main content
GET
Download Card Statement

Overview

Generate a bank-grade PDF statement for a card. The statement includes your business branding (logo, colors, company details), a Card Information panel, a balance Summary, and a full, day-grouped transaction history. The PDF is white-labeled with the branding configured in your Business Settings and is uploaded to storage — the endpoint responds with a 302 redirect to a cdn.fyatu.com download link. Following the redirect (browsers and most HTTP clients do this automatically) downloads the PDF.
The download link is valid for 24 hours, after which the file is automatically deleted. Store the PDF on your side if you need it longer.

Endpoint

Scope required: cards:read

Path Parameters

Query Parameters

Response

Responds with a 302 redirect whose Location header is the download link, e.g.:
Following the redirect returns the PDF (application/pdf). The link is valid for 24 hours.

Statement Contents

The generated PDF includes:
  • Header — business logo, name, and “CARD STATEMENT” on a branded band, plus address & website
  • Card Information — cardholder, masked card number, expiry, scheme, status
  • Summary — Available Balance, Total Money In, Total Money Out, Pending Value (shown only when there is a discrepancy), Currency
  • Transaction Table — transactions grouped by day, with Time, Type (e.g. DEBIT · Cross-border Fee, CREDIT · Funding), Description, Money Out and Money In columns, plus a totals row
  • Footer — your own support contact and a disclaimer (white-label)

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.