> ## Documentation Index
> Fetch the complete documentation index at: https://developer.quickei.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Refunds

> Retrieve refunds for your merchant account

Retrieve a paginated list of refunds for your merchant account, with optional filters.

## Endpoint

`GET https://quickei.io/pay/sandbox/api/v1/refunds`

## Query Parameters

<ParamField query="transaction_id" type="string">
  Filter by original payment transaction ID.
</ParamField>

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

<ParamField query="from_date" type="string">
  Start date filter (ISO 8601, e.g. `2024-01-01`).
</ParamField>

<ParamField query="to_date" type="string">
  End date filter (ISO 8601, e.g. `2024-01-31`).
</ParamField>

<ParamField query="page" type="integer">
  Page number (default: 1).
</ParamField>

<ParamField query="per_page" type="integer">
  Results per page (1–100, default: 20).
</ParamField>

## Example Request

```bash theme={null}
curl -G https://quickei.io/pay/sandbox/api/v1/refunds \
  -H "Authorization: Basic {base64_credentials}" \
  -d "transaction_id=TRX-98765" \
  -d "status=completed" \
  -d "per_page=10"
```

## Success Response `200`

```json theme={null}
{
  "message": {
    "success": ["Refunds retrieved"]
  },
  "data": {
    "refunds": [
      {
        "refund_id": "RF-20240115-X7Y8Z9",
        "transaction_id": "TRX-98765",
        "amount": "10.00 EUR",
        "raw_amount": 10.00,
        "currency": "EUR",
        "status": "completed",
        "reason": "Item returned",
        "reference": "RFD-2024-001",
        "created_at": "2024-01-15T16:30:00+00:00"
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 10,
      "total": 1,
      "last_page": 1
    }
  }
}
```