Skip to main content
GET
/
transactions
List transactions
curl --request GET \
  --url https://api.fyatu.com/api/v3.20/transactions \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Transactions retrieved",
  "data": [
    {
      "transactionId": "txn_01HXYZ8888ABCDEF9999",
      "type": "CARD_FUNDING",
      "direction": "DEBIT",
      "status": "SETTLED",
      "amount": 500,
      "currency": "USD",
      "fee": 0,
      "reference": "fund_01HXYZ5555ABCDEF1111",
      "account": "prg_01HXYZ9876ABCDEF0000",
      "memo": "Card funding — crd_01HXYZ5555ABCDEF1111",
      "balanceBefore": 10000,
      "balanceAfter": 9500,
      "relatedTransactionId": null,
      "completedAt": "2026-05-22T14:32:00Z",
      "createdAt": "2026-05-22T14:30:00Z",
      "cardId": "crd_01HXYZ5555ABCDEF1111"
    }
  ],
  "pagination": {
    "total": 47,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6a7b8c9d0e1f2",
    "platform": "Fyatu CaaS",
    "timestamp": "2026-05-22T15:00:00Z"
  }
}

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 card transactions for your business, scoped to the API key’s environment. Includes authorizations, clearings, declines, reversals, and fees. By default, results span the last 30 days. The maximum date range is 92 days — use multiple requests with different date windows for longer histories.

​
Query Parameters

ParameterTypeDefaultDescription
limitinteger20Results per page (max 100)
offsetinteger0Number of records to skip
fromstring30 days agoStart date/time (YYYY-MM-DD or ISO 8601)
tostringnowEnd date/time (YYYY-MM-DD or ISO 8601)
cardIdstring—Filter to a specific card
cardholderIdstring—Filter to a specific cardholder
programIdstring—Filter to a specific program
typestring—AUTHORIZATION, CLEARING, REVERSAL, REFUND, DECLINE, FEE
statusstring—PENDING, CLEARED, REVERSED, DECLINED
searchstring—Search by merchant name

​
Example

curl -G https://api.fyatu.com/api/v3.20/transactions \
  -H "Authorization: Bearer $FYATU_API_KEY" \
  -d cardId=crd_01HXYZ5555ABCDEF1111 \
  -d from=2026-05-01 \
  -d to=2026-05-31 \
  -d limit=50

​
Success Response (200)

{
  "success": true,
  "status": 200,
  "message": "Transactions retrieved",
  "data": [
    {
      "transactionId": "txn_01HXYZ8888ABCDEF9999",
      "type":          "AUTHORIZATION",
      "status":        "PENDING",
      "amount": {
        "value":        2999,
        "currency":     "USD",
        "displayValue": "29.99"
      },
      "merchant": {
        "name":           "Amazon",
        "city":           "Seattle",
        "country":        "US",
        "mcc":            "5999",
        "mccDescription": "Miscellaneous General Merchandise"
      },
      "cardId":               "crd_01HXYZ5555ABCDEF1111",
      "cardholderId":         "chl_01HXYZ1234ABCDEF5678",
      "programId":            "prg_01HXYZ9876ABCDEF0000",
      "relatedTransactionId": null,
      "environment":          "LIVE",
      "declineReason":        null,
      "processedAt":          null,
      "createdAt":            "2026-05-22T14:30:00Z"
    }
  ],
  "pagination": {
    "total":   47,
    "limit":   50,
    "offset":  0,
    "hasMore": false
  },
  "meta": {
    "requestId": "req_01HXY123456ABCDEF",
    "platform": "Fyatu CaaS",
    "timestamp": "2026-05-22T15:00:00Z"
  }
}

​
Transaction Types

TypeDescription
AUTHORIZATIONPurchase hold — funds reserved but not yet settled
CLEARINGSettled purchase — authorization confirmed
REVERSALAuthorization reversed before settlement
REFUNDMerchant-initiated refund after clearing
DECLINEDeclined authorization attempt
FEEFee charge (e.g. cross-border fee, decline fee)

​
Error Codes

CodeHTTPCause
DATE_RANGE_TOO_WIDE422Date range exceeds the 92-day maximum
VALIDATION_ERROR422Invalid date format or parameters
INSUFFICIENT_SCOPE403Key lacks transactions:read scope

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
limit
integer
default:20
Required range: 1 <= x <= 100
​
offset
integer
default:0
Required range: x >= 0
​
from
string

Start date (YYYY-MM-DD or ISO 8601). Defaults to 30 days ago.

​
to
string

End date (YYYY-MM-DD or ISO 8601). Defaults to now.

​
type
enum<string>
Available options:
DEPOSIT,
WITHDRAWAL,
CARD_FUNDING,
CARD_WITHDRAWAL,
CARD_ISSUANCE,
CARD_TERMINATION_REFUND,
INVOICE_PAYMENT,
REVERSAL
​
status
enum<string>
Available options:
PENDING,
SETTLED,
FAILED,
REVERSED
​
direction
enum<string>
Available options:
CREDIT,
DEBIT
​
cardId
string

Filter to movements related to a specific card

​
search
string

Search by memo or reference

Response

Transactions retrieved

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
Example:

"Transactions retrieved"

​
data
object[]
​
pagination
object
​
meta
object