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

> Retrieve recent POS orders

Retrieve a list of recent POS orders for your merchant account.

## Endpoint

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

## Query Parameters

<ParamField query="status" type="string">
  Filter by status: `PENDING`, `PAID`, `EXPIRED`, `CANCELLED`, `REFUNDED`, `REFUND_PENDING`
</ParamField>

<ParamField query="terminal_id" type="string">
  Filter by terminal identifier
</ParamField>

> **Note:** Returns the last 50 orders, sorted by most recent first.

## Example Request

```bash theme={null}
GET /merchant-api/pos/v1/orders?status=PAID&terminal_id=terminal-01
Authorization: Basic {base64_credentials}
```

## Success Response `200`

```json theme={null}
{
  "message": {
    "success": ["POS orders retrieved"]
  },
  "data": {
    "orders": [
      {
        "order_id": "POS-20240115-A1B2C3",
        "amount": "25.00 EUR",
        "raw_amount": 25.00,
        "currency": "EUR",
        "payment_method": "both",
        "reference": "INV-2024-001",
        "status": "PAID",
        "terminal_id": "terminal-01",
        "paid_at": "2024-01-15T14:02:30+00:00",
        "created_at": "2024-01-15T14:00:00+00:00"
      }
    ]
  }
}
```