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

# GET /orders/{uuid}

> Get a specific order by its UUID.

#### Authentication

This endpoint requires authentication. See [Authentication](/api-reference/authentication) for detailed information about required headers and how to obtain your API keys.

#### Path Parameters

<ParamField path="uuid" type="string" required>
  The unique identifier (UUID) of the order to retrieve.
</ParamField>

#### Query Params

<ParamField path="formatDates" type="boolean" default="false">
  Whether to format dates according to the locale. When set to `true`, dates
  will be formatted in a human-readable format based on the X-LOCALE header.
</ParamField>

<ParamField path="includeGuestNames" type="boolean" default="false">
  Whether to include guest names in the response. When set to `true`, the
  response will include guest name information.
</ParamField>

#### Example Requests

**Basic request:**

```bash theme={null}
GET /orders/order_123456
```

**With formatted dates and guest names:**

```bash theme={null}
GET /orders/order_123456?formatDates=true&includeGuestNames=true
```

#### Response

```json theme={null}
{
	"uuid": "67890abc-def1-2345-6789-0123456789ab",
	"orderDate": "2025-01-15T14:30:00.000Z",
	"totalAmount": 250.0,
	"status": "confirmed",
	"guestNames": ["John Doe", "Jane Smith"],
	"items": [
		{
			"name": "Room Upgrade",
			"quantity": 1,
			"price": 150.0,
			"itemId": "item_abc123"
		},
		{
			"name": "Spa Treatment",
			"quantity": 2,
			"price": 50.0,
			"itemId": "item_def456"
		}
	],
	"billingAddress": {
		"street": "123 Main St",
		"city": "New York",
		"zip": "10001",
		"country": "US"
	},
	"paymentMethod": "credit_card",
	"paymentStatus": "paid",
	"notes": "Special request for early check-in",
	"createdAt": "2025-01-15T10:00:00.000Z",
	"updatedAt": "2025-01-15T14:30:00.000Z"
}
```

#### Error Responses

<ResponseField name="400" type="Bad Request">
  Invalid UUID parameter
</ResponseField>

<ResponseField name="401" type="Unauthorized">
  Missing or invalid authentication headers
</ResponseField>

<ResponseField name="403" type="Forbidden">
  Insufficient permissions to access order data
</ResponseField>

<ResponseField name="404" type="Not Found">
  Order not found or invalid Order ID provided
</ResponseField>