Skip to main content
GET
/
api
/
yativo-card
/
{yativoCardId}
/
cards
/
{cardId}
/
transactions
curl -X GET 'https://crypto-api.yativo.com/api/yativo-card/yvc_01HX9KZMB3F7VNQP8R2WDGT4EI/cards/crd_01HX9KZMB3F7VNQP8R2WDGT4EJ/transactions?limit=20&status=completed&from_date=2026-03-01T00:00:00Z' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "data": {
    "transactions": [
      {
        "kind": "Payment",
        "transaction_type": "Purchase",
        "merchant_name": "Coffee Shop NYC",
        "merchant_city": "New York",
        "merchant_country": "United States",
        "merchant_country_code": "US",
        "mcc_code": "5812",
        "mcc_description": "Eating Places, Restaurants",
        "mcc_category": "Food & Beverage",
        "billing_amount": 5.31,
        "billing_currency": "USD",
        "billing_formatted": "$5.31",
        "transaction_amount": 5.31,
        "transaction_currency": "USD",
        "amount": 5.31,
        "currency": "USD",
        "status": "approved",
        "status_label": "Approved",
        "status_note": "Payment settled successfully.",
        "is_pending": false,
        "authorized_at": "2026-03-10T20:54:34.501Z",
        "cleared_at": "2026-03-13T16:25:58.395Z",
        "blockchain_transactions": [
          {
            "status": "ExecSuccess",
            "hash": "0xabc123def456789012345678901234567890abcdef1234567890abcdef123456"
          }
        ]
      }
    ],
    "pagination": {"total": 1, "limit": 50, "offset": 0, "has_more": false}
  }
}
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
yativoCardId
string
required
The Yativo Card account ID.
​
cardId
string
required
The card ID to retrieve transactions for.
​
limit
integer
Number of transactions to return. Defaults to 20.
​
offset
integer
Number of records to skip. Defaults to 0.
​
status
string
Filter by transaction status. One of: pending, completed, declined, refunded, disputed.
​
from_date
string
Start date filter in ISO 8601 format, e.g. 2026-01-01T00:00:00Z.
​
to_date
string
End date filter in ISO 8601 format, e.g. 2026-03-26T23:59:59Z.
curl -X GET 'https://crypto-api.yativo.com/api/yativo-card/yvc_01HX9KZMB3F7VNQP8R2WDGT4EI/cards/crd_01HX9KZMB3F7VNQP8R2WDGT4EJ/transactions?limit=20&status=completed&from_date=2026-03-01T00:00:00Z' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "data": {
    "transactions": [
      {
        "kind": "Payment",
        "transaction_type": "Purchase",
        "merchant_name": "Coffee Shop NYC",
        "merchant_city": "New York",
        "merchant_country": "United States",
        "merchant_country_code": "US",
        "mcc_code": "5812",
        "mcc_description": "Eating Places, Restaurants",
        "mcc_category": "Food & Beverage",
        "billing_amount": 5.31,
        "billing_currency": "USD",
        "billing_formatted": "$5.31",
        "transaction_amount": 5.31,
        "transaction_currency": "USD",
        "amount": 5.31,
        "currency": "USD",
        "status": "approved",
        "status_label": "Approved",
        "status_note": "Payment settled successfully.",
        "is_pending": false,
        "authorized_at": "2026-03-10T20:54:34.501Z",
        "cleared_at": "2026-03-13T16:25:58.395Z",
        "blockchain_transactions": [
          {
            "status": "ExecSuccess",
            "hash": "0xabc123def456789012345678901234567890abcdef1234567890abcdef123456"
          }
        ]
      }
    ],
    "pagination": {"total": 1, "limit": 50, "offset": 0, "has_more": false}
  }
}