Skip to main content
GET
/
cards
/
{id}
/
transactions
List card transactions
curl --request GET \
  --url https://api.fyatu.com/api/v3.20/cards/{id}/transactions \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Card transactions retrieved",
  "data": [
    {
      "transactionId": "hf_txn_01HXYZ1234ABCDEF0001",
      "cardId": "crd_01HXYZ5555ABCDEF1111",
      "type": "PURCHASE",
      "status": "SETTLED",
      "amount": 12.5,
      "feeAmount": 0,
      "currency": "USD",
      "merchant": {
        "name": "STARBUCKS #1234",
        "id": "MER_STARBUCKS_001",
        "city": "San Francisco",
        "country": "US",
        "mcc": "5812",
        "mccCategory": "Eating Places, Restaurants"
      },
      "memo": "STARBUCKS #1234",
      "isSettled": true,
      "wasReversed": false,
      "createdAt": "2026-05-25T14:32:00Z"
    },
    {
      "transactionId": "hf_txn_01HXYZ1234ABCDEF0002",
      "cardId": "crd_01HXYZ5555ABCDEF1111",
      "type": "PURCHASE",
      "status": "DECLINED",
      "amount": 250,
      "feeAmount": 0,
      "currency": "USD",
      "merchant": {
        "name": "AMAZON.COM",
        "id": "MER_AMAZON_001",
        "city": "Seattle",
        "country": "US",
        "mcc": "5999",
        "mccCategory": "Miscellaneous Retail Stores"
      },
      "memo": "AMAZON.COM",
      "isSettled": false,
      "wasReversed": false,
      "createdAt": "2026-05-24T09:10:00Z"
    }
  ],
  "pagination": {
    "total": 47,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6a7b8c9d0e1f2",
    "platform": "Fyatu CaaS",
    "timestamp": "2026-05-26T10:00:00Z"
  }
}

​
Overview

Returns a paginated list of card-level transactions sourced directly from the card network. This includes purchases, declines, refunds, reversals, and fees — everything that moved money on the physical card.
These are card-to-merchant transactions, not program ledger movements. For deposits, withdrawals, and card funding/unload events, use GET /transactions instead.

​
Path Parameters

ParameterTypeDescription
idstringThe card ID (prefix crd_)

​
Query Parameters

ParameterTypeDefaultDescription
pageinteger1Page number (1-based)
limitinteger20Results per page (max: 100)

​
Transaction Object

FieldTypeDescription
transactionIdstringUnique transaction identifier from the card network
cardIdstringThe card ID this transaction belongs to
typestringTransaction type (e.g. PURCHASE, REFUND, FEE)
statusstringSETTLED, PENDING, DECLINED, REVERSED
amountnumberTransaction amount in card currency
feeAmountnumberNetwork fee charged (if any)
currencystringTransaction currency (e.g. USD)
merchantobjectMerchant details — present for purchase transactions
merchant.namestringMerchant name
merchant.idstringMerchant ID at the network
merchant.citystringMerchant city
merchant.countrystringMerchant country code
merchant.mccstringMerchant Category Code
merchant.mccCategorystringHuman-readable MCC description
memostringTransaction memo or description
isSettledbooleanWhether the transaction has cleared
wasReversedbooleanWhether the transaction was reversed
createdAtstringTransaction timestamp (ISO 8601)

​
Example

curl https://api.fyatu.com/api/v3.20/cards/crd_01HXYZ5555ABCDEF1111/transactions \
  -H "Authorization: Bearer $FYATU_API_KEY"

​
Success Response (200)

{
  "success": true,
  "status": 200,
  "message": "Card transactions retrieved",
  "data": [
    {
      "transactionId": "hf_txn_01HXYZ1234ABCDEF0001",
      "cardId": "crd_01HXYZ5555ABCDEF1111",
      "type": "PURCHASE",
      "status": "SETTLED",
      "amount": 12.50,
      "feeAmount": 0.00,
      "currency": "USD",
      "merchant": {
        "name": "STARBUCKS #1234",
        "id": "MER_STARBUCKS_001",
        "city": "San Francisco",
        "country": "US",
        "mcc": "5812",
        "mccCategory": "Eating Places, Restaurants"
      },
      "memo": "STARBUCKS #1234",
      "isSettled": true,
      "wasReversed": false,
      "createdAt": "2026-05-25T14:32:00Z"
    },
    {
      "transactionId": "hf_txn_01HXYZ1234ABCDEF0002",
      "cardId": "crd_01HXYZ5555ABCDEF1111",
      "type": "PURCHASE",
      "status": "DECLINED",
      "amount": 250.00,
      "feeAmount": 0.00,
      "currency": "USD",
      "merchant": {
        "name": "AMAZON.COM",
        "id": "MER_AMAZON_001",
        "city": "Seattle",
        "country": "US",
        "mcc": "5999",
        "mccCategory": "Miscellaneous Retail Stores"
      },
      "memo": "AMAZON.COM",
      "isSettled": false,
      "wasReversed": false,
      "createdAt": "2026-05-24T09:10:00Z"
    }
  ],
  "pagination": {
    "total": 47,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  },
  "meta": {
    "requestId": "req_01HXY123456ABCDEF",
    "platform": "Fyatu CaaS",
    "timestamp": "2026-05-26T10:00:00Z"
  }
}
If the card has not yet been fully provisioned by the card network, the data array will be empty and pagination.total will be 0.

​
Error Codes

CodeHTTPCause
CARD_NOT_FOUND404Card does not exist or belongs to another business/environment
PROVIDER_ERROR500Card network unavailable — retry with exponential back-off
INSUFFICIENT_SCOPE403Key lacks cards:read scope

Authorizations

​
Authorization
string
header
required

API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.

Path Parameters

​
id
string
required

Query Parameters

​
page
integer
default:1

Page number (1-based)

Required range: x >= 1
​
limit
integer
default:20

Results per page

Required range: 1 <= x <= 100

Response

Card transactions retrieved

​
success
boolean
​
status
integer
​
message
string
​
data
object[]
​
pagination
object
​
meta
object