Skip to main content
GET
/
cards
/
{cardId}
/
statement
Download Card Statement
curl --request GET \
  --url https://api.fyatu.com/api/v3/cards/{cardId}/statement \
  --header 'Authorization: Bearer <token>'
"<string>"

​
Overview

Download a PDF statement for a card. The statement includes your business branding (logo, colors, company details), card information, cardholder billing address, and a full transaction history. The PDF is white-labeled with the branding configured in your Business Settings.

​
Endpoint

GET /api/v3/cards/{cardId}/statement
Scope required: cards:read

​
Path Parameters

ParameterTypeRequiredDescription
cardIdstringYesUnique card identifier

​
Query Parameters

ParameterTypeRequiredDescription
fromstringNoStart date (YYYY-MM-DD). Defaults to card creation date.
tostringNoEnd date (YYYY-MM-DD). Defaults to today.

​
Response

Returns a PDF file (application/pdf) with the card statement. The Content-Disposition header contains the filename in the format: 
statement_{scheme}_{cardholder_name}_{unique_id}.pdf

​
Statement Contents

The generated PDF includes:
  • Header - Business logo, company name, and “CARD STATEMENT” label on a branded background
  • Company Details - Business address, website, email, phone
  • Cardholder Info - Name, billing address
  • Card Details - Card number (masked), type, currency, status
  • Statement Period - From/to dates
  • Transaction Table - Date, description, debit, credit columns with opening and closing balances
  • Important Notice - Disclaimer footer

​
Example Usage

<?php
$cardId = 'CRD678A3B4C5D6E7';

// Download statement for a specific date range
$url = "https://api.fyatu.com/api/v3/cards/{$cardId}/statement?from=2026-03-01&to=2026-03-31";

$response = file_get_contents($url, false, stream_context_create([
    'http' => [
        'method' => 'GET',
        'header' => 'Authorization: Bearer ' . $accessToken,
    ]
]));

// Save to file
file_put_contents("card_statement_{$cardId}.pdf", $response);

​
Error Responses

​
Card Not Found (404)

{
  "success": false,
  "status": 404,
  "message": "Card not found",
  "error": { "code": "NOT_FOUND" }
}

​
Card Still Provisioning (202)

{
  "success": false,
  "status": 202,
  "message": "Card is still being provisioned",
  "error": { "code": "CARD_PROVISIONING" }
}
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.