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

# List Customer Transfers

> List all funding transfers sent to a specific customer's card

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

<ParamField path="customerId" type="string" required>
  Any customer identifier: `yativo_card_id`, `customer_id`, or your own `external_id`.
</ParamField>

<ParamField query="page" type="integer">Page number. Defaults to `1`.</ParamField>

<ParamField query="limit" type="integer">Results per page. Defaults to `20`, max `100`.</ParamField>

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

<RequestExample>
  ```bash cURL (by yativo_card_id) theme={null}
  curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/customers/yativo_card_customer_8f9a...abc/transfers' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
  ```

  ```bash cURL (by external_id) theme={null}
  curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/customers/usr_8821/transfers' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "success": true,
    "data": {
      "customer_id": "yativo_card_customer_8f9a...abc_1769031332068",
      "transfers": [
        {
          "transfer_id": "bridge_1746541800_2ea87af00de1",
          "source_chain": "SOL",
          "source_amount": 201.80,
          "destination_currency": "EUR",
          "destination_amount": 200.00,
          "status": "completed",
          "initiated_at": "2026-05-06T14:30:00Z",
          "completed_at": "2026-05-06T14:33:22Z"
        },
        {
          "transfer_id": "bridge_1746443564_3fb98bc11ef2",
          "source_chain": "SOL",
          "source_amount": 51.00,
          "destination_currency": "EUR",
          "destination_amount": 50.00,
          "status": "completed",
          "initiated_at": "2026-05-05T09:12:44Z",
          "completed_at": "2026-05-05T09:16:01Z"
        }
      ],
      "total": 2,
      "page": 1,
      "limit": 20
    }
  }
  ```

  ```json 404 Customer not found theme={null}
  {
    "success": false,
    "error": "CUSTOMER_NOT_FOUND",
    "message": "No customer found matching the provided identifier"
  }
  ```
</ResponseExample>