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

# Customer Card Transactions

> List all transactions across all cards for a customer

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

<ParamField path="yativoCardId" type="string" required>
  The customer's `yativo_card_id`.
</ParamField>

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

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

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

<ParamField query="from_date" type="string">ISO 8601 start date filter.</ParamField>

<ParamField query="to_date" type="string">ISO 8601 end date filter.</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a..._1769031332068/transactions?limit=20&status=completed' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK 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",
          "amount": 4.50,
          "currency": "EUR",
          "status": "completed",
          "transaction_date": "2026-04-01T09:14:00.000Z"
        }
      ],
      "total": 47
    }
  }
  ```
</ResponseExample>