> ## Documentation Index
> Fetch the complete documentation index at: https://docs.e-cubee.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get an order

> Retrieve an order by its order number or ID.

Returns an order created with the same API key. Your key needs the `orders:find` scope.

## Headers

<ParamField header="X-Api-Key" type="string" required>Your API key. You can use `Authorization: Api-Key your_key` instead.</ParamField>

## Path parameters

<ParamField path="orderNumberOrId" type="string" required>Order number or order GUID.</ParamField>

## Request example

```bash theme={null}
curl "$MORABAA_API_URL/external/v1/orders/ORD-1042" \
  --header "X-Api-Key: $MORABAA_API_KEY"
```

## Response

<ResponseField name="id" type="UUID" required>Order ID.</ResponseField>
<ResponseField name="orderNumber" type="string" required>Order number.</ResponseField>
<ResponseField name="status" type="string" required>Current order status.</ResponseField>
<ResponseField name="total" type="number" required>Order subtotal.</ResponseField>
<ResponseField name="finalTotal" type="number" required>Final order total.</ResponseField>
<ResponseField name="productsCount" type="integer" required>Total item quantity.</ResponseField>
<ResponseField name="date" type="string" required>Order date and time in ISO 8601 format.</ResponseField>
<ResponseField name="customerName" type="string" required>Customer name.</ResponseField>
<ResponseField name="customerPhone" type="string | null">Customer phone.</ResponseField>
<ResponseField name="note" type="string | null">Order note.</ResponseField>

<ResponseField name="items" type="object[]" required>
  Order items. Each item contains `productId`, `combinationId`, `name`, `quantity`, `singlePrice`, and `totalPrice`.
</ResponseField>

```json theme={null}
{
  "id": "55555555-5555-5555-5555-555555555555",
  "orderNumber": "ORD-1042",
  "status": "Pending",
  "total": 20000,
  "finalTotal": 20000,
  "productsCount": 2,
  "date": "2026-08-16T10:30:00+03:00",
  "customerName": "Ahmed Ali",
  "customerPhone": "+9647700000000",
  "note": "Leave at reception",
  "items": [{
    "productId": "11111111-1111-1111-1111-111111111111",
    "combinationId": null,
    "name": "Arabic coffee",
    "quantity": 2,
    "singlePrice": 10000,
    "totalPrice": 20000
  }]
}
```

## Errors

| Status | Cause                                          |
| ------ | ---------------------------------------------- |
| `401`  | The API key is missing or invalid.             |
| `403`  | The key lacks the `orders:find` scope.         |
| `404`  | No accessible order matches `orderNumberOrId`. |
| `429`  | The rate limit was exceeded.                   |
| `500`  | An unexpected error occurred.                  |

```json theme={null}
{
  "error": "order_not_found",
  "message": "No order matches the given identifier."
}
```