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

# Get Order

> Get details of a specific order

Retrieve the full details and current status of a specific POS order.

## Endpoint

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

## Path Parameters

<ParamField path="order_id" type="string" required>
  The POS order ID (e.g. `POS-20240115-A1B2C3`)
</ParamField>

> **Auto-expiry:** If the order is still PENDING and past its `expires_at`, the API will automatically mark it as EXPIRED before returning.

## Response Fields

| Field         | Description                                                             |
| ------------- | ----------------------------------------------------------------------- |
| `order_id`    | Unique POS order identifier                                             |
| `amount`      | Formatted amount with currency (e.g. `25.00 EUR`)                       |
| `raw_amount`  | Numeric amount value                                                    |
| `status`      | `PENDING`, `PAID`, `EXPIRED`, `CANCELLED`, `REFUNDED`, `REFUND_PENDING` |
| `qr_data`     | QR code data string (when `payment_method` includes qr)                 |
| `payment_url` | Hosted payment page URL (when `payment_method` includes page)           |
| `trx_id`      | Quickei transaction ID (null until paid)                                |
| `paid_at`     | ISO 8601 timestamp of payment (null until paid)                         |

## Example Request

```bash theme={null}
GET /merchant-api/pos/v1/orders/POS-20240115-A1B2C3
Authorization: Basic {base64_credentials}
```

## Success Response `200`

```json theme={null}
{
  "message": {
    "success": ["Order status retrieved"]
  },
  "data": {
    "order_id": "POS-20240115-A1B2C3",
    "amount": "25.00 EUR",
    "raw_amount": 25.00,
    "currency": "EUR",
    "payment_method": "both",
    "reference": "INV-2024-001",
    "description": "Table 5 - Lunch",
    "terminal_id": "terminal-01",
    "status": "PAID",
    "qr_data": "quickei://pay?order=POS-20240115-A1B2C3&a=25.00&c=EUR",
    "payment_url": "https://quickei.io/pay/pos/POS-20240115-A1B2C3",
    "trx_id": "TRX-98765",
    "paid_at": "2024-01-15T14:02:30+00:00",
    "expires_at": "2024-01-15T14:05:00+00:00",
    "created_at": "2024-01-15T14:00:00+00:00"
  }
}
```

## Error Response `404`

```json theme={null}
{
  "message": {
    "error": ["Order not found"]
  }
}
```