Skip to main content
GET
/
v1
/
card-issuer
/
card-transactions
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/card-transactions' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "data": {
    "transactions": [
      {
        "transaction_id": "tx_9d8e7f6a5b4c3d2e",
        "yativo_card_id": "yativo_card_customer_8f9a...",
        "card_id": "card_token_abc123",
        "type": "purchase",
        "amount": 12.50,
        "currency": "EUR",
        "status": "settled",
        "merchant": "Starbucks",
        "merchant_category": "5812",
        "merchant_city": "Paris",
        "merchant_country": "FR",
        "authorized_at": "2026-05-12T14:15:00.000Z",
        "settled_at": "2026-05-13T02:00:00.000Z",
        "created_at": "2026-05-12T14:15:00.000Z"
      },
      {
        "transaction_id": "tx_1a2b3c4d5e6f7g8h",
        "yativo_card_id": "yativo_card_customer_ab12...",
        "card_id": "card_token_def456",
        "type": "purchase",
        "amount": 45.00,
        "currency": "USD",
        "status": "authorized",
        "merchant": "Amazon",
        "merchant_category": "5999",
        "merchant_city": "Seattle",
        "merchant_country": "US",
        "authorized_at": "2026-05-12T16:30:00.000Z",
        "settled_at": null,
        "created_at": "2026-05-12T16:30:00.000Z"
      }
    ],
    "total": 318,
    "page": 1,
    "limit": 20
  }
}

Documentation Index

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

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

​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
page
integer
Page number. Defaults to 1.
​
limit
integer
Results per page. Defaults to 20, max 100.
​
status
string
Filter by transaction status. One of: authorized, settled, declined, reversed, partially_reversed, failed, expired.
​
customer_id
string
Filter by customer — pass a yativo_card_id to see transactions for a specific customer.
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/card-transactions' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "data": {
    "transactions": [
      {
        "transaction_id": "tx_9d8e7f6a5b4c3d2e",
        "yativo_card_id": "yativo_card_customer_8f9a...",
        "card_id": "card_token_abc123",
        "type": "purchase",
        "amount": 12.50,
        "currency": "EUR",
        "status": "settled",
        "merchant": "Starbucks",
        "merchant_category": "5812",
        "merchant_city": "Paris",
        "merchant_country": "FR",
        "authorized_at": "2026-05-12T14:15:00.000Z",
        "settled_at": "2026-05-13T02:00:00.000Z",
        "created_at": "2026-05-12T14:15:00.000Z"
      },
      {
        "transaction_id": "tx_1a2b3c4d5e6f7g8h",
        "yativo_card_id": "yativo_card_customer_ab12...",
        "card_id": "card_token_def456",
        "type": "purchase",
        "amount": 45.00,
        "currency": "USD",
        "status": "authorized",
        "merchant": "Amazon",
        "merchant_category": "5999",
        "merchant_city": "Seattle",
        "merchant_country": "US",
        "authorized_at": "2026-05-12T16:30:00.000Z",
        "settled_at": null,
        "created_at": "2026-05-12T16:30:00.000Z"
      }
    ],
    "total": 318,
    "page": 1,
    "limit": 20
  }
}

​
Transaction fields

FieldDescription
transaction_idUnique identifier for this transaction
yativo_card_idThe Yativo customer identifier who owns the card
card_idThe card token the transaction was charged to
typeTransaction kind — typically purchase, refund, or withdrawal
amountTransaction amount
currencyCurrency code (USD, EUR, GBP)
statusCurrent status (see below)
merchantMerchant name
merchant_categoryMerchant category code (MCC)
merchant_cityMerchant city
merchant_countryTwo-letter ISO country code
authorized_atWhen the transaction was authorized
settled_atWhen the transaction settled (null if still pending)
created_atWhen the transaction record was first created

​
Transaction statuses

StatusMeaning
authorizedApproved at point of sale; funds are held pending settlement
settledTransaction has settled and funds have been debited
declinedTransaction was declined
reversedTransaction was fully reversed
partially_reversedTransaction was partially reversed
failedTransaction failed after authorization
expiredAuthorization expired before settlement
Transactions are recorded in real time as card events arrive. For per-customer transaction history, use Customer Card Transactions. Transaction events are also delivered via webhooks (transaction.authorized, transaction.settled, transaction.declined, transaction.reversed).