# Get Order

`GET /api/v1/orders/{external_id}`

Retrieves one Order by its point-of-sale id and business date. A POS id is unique only within a location; pass `location_id` when the token can read several. Requires the `read` ability and the export orders permission.

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `external_id` | string | yes | The order's point-of-sale id (the `id` field of an Order). |

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `business_date` | string | yes |  |
| `location_id` | string | no | The location UUID, needed when two locations share the POS id on that date. |
| `include` | string | no | Comma-separated. Allowed: items, payments. |

## Example request

```bash
curl "https://app.franchisesee.com/api/v1/orders/STORE-1042?business_date=2026-11-12" \
  -H "Authorization: Bearer $FRANCHISESEE_TOKEN" \
  -H "Accept: application/json"
```

## Responses

### 200 Success

```json
{
    "data": {
        "id": "100245871",
        "location": {
            "id": "9b1c8f3e-7a2d-4c5b-8e1a-2f3d4c5b6a7e",
            "name": "Downtown Austin"
        },
        "order_created_at": "2026-06-08T10:01:17",
        "payment_at": "2026-06-08T10:14:02",
        "business_date_on": "2026-06-08",
        "check_number": "318",
        "device_id": "2",
        "employee_id": "10457",
        "day_part_id": "2",
        "channel": {
            "id": "3",
            "name": "Online"
        },
        "order_type": {
            "id": "1",
            "name": "Pickup"
        },
        "total_amount": 24.87,
        "tax_amount": 1.89,
        "tip_amount": 2,
        "service_charge_amount": 0,
        "discount_amount": 2,
        "gift_card_amount": 0,
        "net_sales_amount": 20.98,
        "void_amount": 0,
        "num_customers": 1,
        "guest_count": 1,
        "items": [
            {
                "description": "Chicken Burrito Bowl",
                "item_external_id": "10233",
                "category_uuid": "b8d1f3a5-7c9e-4b2d-a6f8-0e3c5a7d9b12",
                "quantity": 1,
                "price": 11.49,
                "discount_amount": 1,
                "net_sales_amount": 10.49,
                "num_customers": 1
            }
        ],
        "payments": [
            {
                "tender_type_id": "4",
                "card_brand": "Visa",
                "amount": 24.87,
                "tip_amount": 2,
                "paid_at": "2026-06-08T10:14:02"
            }
        ]
    },
    "meta": {
        "data_from": "2024-01-01"
    }
}
```

### 401 Authentication failed or missing.

```json
{
    "message": "Unauthenticated."
}
```

### 403 The token lacks the required ability or the caller is not permitted.

```json
{
    "message": "This API token does not have the 'create' ability."
}
```

### 404 Resource not found.

```json
{
    "message": "Record not found."
}
```

### 422 Validation failed.

```json
{
    "message": "The name field is required.",
    "errors": {
        "name": [
            "The name field is required."
        ]
    }
}
```

### 503 Order history is busy; retry after the `Retry-After` header's seconds.
