Skip to main content
GET
/
transactions
/
{id}
Get a transaction
curl --request GET \
  --url https://api.fyatu.com/api/v3.20/transactions/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Transaction 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"
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6a7b8c9d0e1f2",
    "platform": "Fyatu CaaS",
    "timestamp": "2026-05-22T15:00:00Z"
  }
}

​
Overview

Returns the full details of a single program-balance transaction, including the balance snapshot before and after the movement and any linked card details.

​
Path Parameters

ParameterTypeDescription
idstringThe transaction ID (prefix txn_)

​
Example

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

​
Success Response (200)

{
  "success": true,
  "status":  200,
  "message": "Transaction retrieved",
  "data": {
    "transactionId":        "txn_01HXYZ8888ABCDEF9999",
    "type":                 "CARD_FUNDING",
    "direction":            "DEBIT",
    "status":               "SETTLED",
    "amount":               500.00,
    "currency":             "USD",
    "fee":                  0.00,
    "reference":            "fund_01HXYZ5555ABCDEF1111",
    "account":              "prg_01HXYZ9876ABCDEF0000",
    "memo":                 "Card funding — crd_01HXYZ5555ABCDEF1111",
    "balanceBefore":        10000.00,
    "balanceAfter":         9500.00,
    "relatedTransactionId": null,
    "completedAt":          "2026-05-22T14:32:00Z",
    "createdAt":            "2026-05-22T14:30:00Z",
    "cardId":               "crd_01HXYZ5555ABCDEF1111"
  },
  "meta": {
    "requestId":  "req_01HXY123456ABCDEF",
    "platform": "Fyatu CaaS",
    "timestamp":  "2026-05-22T15:00:00Z"
  }
}

​
Field Reference

FieldDescription
transactionIdUnique transaction identifier
typeMovement type — see List Transactions for all values
directionCREDIT (funds in) or DEBIT (funds out)
statusPENDING, SETTLED, FAILED, or REVERSED
amountTransaction amount in USD
currencyAlways USD
feeFee in USD applied to this transaction (0 when no fee)
referenceInternal reference ID linking to the originating operation
accountProgram ID associated with this movement
memoHuman-readable description of the transaction
balanceBeforeOperational balance in USD before this transaction; null if not recorded
balanceAfterOperational balance in USD after this transaction; null if not recorded
relatedTransactionIdFor reversals, the ID of the original transaction; null otherwise
completedAtISO 8601 timestamp when the transaction settled; empty string if still pending
cardIdCard ID if the movement is card-related; null otherwise

​
Error Codes

CodeHTTPCause
TRANSACTION_NOT_FOUND404Transaction does not exist or belongs to another business/environment
INSUFFICIENT_SCOPE403Key lacks accounts:read scope

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

Response

Transaction retrieved

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
Example:

"Transaction retrieved"

​
data
object
​
meta
object