> ## 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.

# Card Transactions

> Retrieve the transaction history for a specific card

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer YOUR_ACCESS_TOKEN`
</ParamField>

<ParamField path="yativoCardId" type="string" required>
  The Yativo Card account ID.
</ParamField>

<ParamField path="cardId" type="string" required>
  The card ID to retrieve transactions for.
</ParamField>

<ParamField query="limit" type="integer">
  Number of transactions to return. Defaults to `20`.
</ParamField>

<ParamField query="offset" type="integer">
  Number of records to skip. Defaults to `0`.
</ParamField>

<ParamField query="status" type="string">
  Filter by transaction status. One of: `pending`, `completed`, `declined`, `refunded`, `disputed`.
</ParamField>

<ParamField query="from_date" type="string">
  Start date filter in ISO 8601 format, e.g. `2026-01-01T00:00:00Z`.
</ParamField>

<ParamField query="to_date" type="string">
  End date filter in ISO 8601 format, e.g. `2026-03-26T23:59:59Z`.
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl -X GET 'https://crypto-api.yativo.com/api/v1/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'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "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}
    }
  }
  ```
</ResponseExample>