Skip to main content
GET
/
cards
/
{cardId}
/
transactions
Get Card Transactions
curl --request GET \
  --url https://api.fyatu.com/api/v3/cards/{cardId}/transactions \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Transactions retrieved successfully",
  "data": {
    "transactions": [
      {
        "id": "8a7b6c5d4e3f2a1b0c9d8e7f",
        "type": "DEBIT",
        "amount": 15.99,
        "currency": "USD",
        "merchant": "Netflix",
        "logo": "https://logos.ntropy.com/netflix.com",
        "status": "COMPLETED",
        "description": "NETFLIX.COM              LOS GATOS",
        "createdAt": "2026-01-15 14:32:18"
      },
      {
        "id": "1b2c3d4e5f6a7b8c9d0e1f2a",
        "type": "CREDIT",
        "amount": 100,
        "currency": "USD",
        "merchant": "Card Funding",
        "logo": "https://logos.ntropy.com/consumer_icons-ATM_bank_deposit",
        "status": "COMPLETED",
        "description": "Mastercard Virtual dollar card funding",
        "createdAt": "2026-01-14 09:15:42"
      },
      {
        "id": "3c4d5e6f7a8b9c0d1e2f3a4b",
        "type": "DEBIT",
        "amount": 49.99,
        "currency": "USD",
        "merchant": "Spotify",
        "logo": "https://logos.ntropy.com/spotify.com",
        "status": "COMPLETED",
        "description": "SPOTIFY PREMIUM          STOCKHOLM",
        "createdAt": "2026-01-12 11:05:33"
      },
      {
        "id": "5e6f7a8b9c0d1e2f3a4b5c6d",
        "type": "DEBIT",
        "amount": 25,
        "currency": "USD",
        "merchant": "Card Withdrawal",
        "logo": "https://logos.ntropy.com/consumer_icons-ATM_bank_withdrawal",
        "status": "COMPLETED",
        "description": "Mastercard Virtual dollar card unloading",
        "createdAt": "2026-01-10 16:48:21"
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalItems": 47,
      "totalPages": 3,
      "hasMore": true
    }
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6g7h8",
    "timestamp": "2026-01-17T12:00:00+00:00"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Returns a paginated list of transactions for a specific card, including purchases, declines, refunds, funding, and unload operations.

​
Path Parameters

ParameterTypeDescription
cardIdstringThe card ID

​
Query Parameters

ParameterTypeDescription
pageintegerPage number (default: 1)
limitintegerResults per page (default: 20, max: 100)
typestringFilter by type: PURCHASE, DECLINE, REFUND, FUND, UNLOAD, FEE
fromstringStart date (ISO 8601)
tostringEnd date (ISO 8601)

​
Transaction Types

TypeDescription
PURCHASESuccessful card purchase
DECLINEDeclined transaction attempt
REFUNDMerchant refund
FUNDBalance added to card
UNLOADBalance removed from card
FEEFee deducted from card balance

​
Response Fields

FieldTypeDescription
idstringTransaction ID
typestringTransaction type
amountnumberTransaction amount
currencystringTransaction currency
merchantNamestringMerchant name (purchases only)
merchantCategorystringMCC category code
statusstringAPPROVED, DECLINED, REVERSED
createdAtstringTransaction timestamp

Authorizations

​
Authorization
string
header
required

JWT access token obtained from /auth/token

Path Parameters

​
cardId
string
required

Query Parameters

​
page
integer
default:1
​
limit
integer
default:20
Required range: x <= 100

Response

Transactions retrieved

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
​
data
object
​
meta
object