# Check specific travel services details in an order **Find in this section instructions and best practices when getting details about travel services reservations, so you can perform different post-booking tasks**. ## Overview Use the following endpoints to access details of different travel service orders: | Endpoint | Action | Use it to... | | --- | --- | --- | | [/orders/details/accommodations](/demand/docs/open-api/demand-api/orders/orders/details/accommodations) | Retrieves information about the accommodation-specific part of the order. | ✓ Provide travellers with details of a specific accommodation order. ✓ Check applied cancellation policies and order status. | | [/orders/details/cars](/demand/docs/open-api/demand-api/orders/orders/details/cars) | Retrieves details about the car rental specific part of the order. | ✓ Provide travellers with details of a specific car rental order. ✓ Check order status. | | [/orders/details/flights](/demand/docs/open-api/demand-api/orders/orders/details/flights) | Returns the flight information included in an order. | ✓ Provide travellers with details about a specific flight order. ✓ Check order status. | Important * Results are sorted by order creation date in descending order (most recent first). * You can retrieve orders or reservations **up to 1 year old**. * Use the extras parameter to control which additional fields are returned. ## /orders/details/accommodations Use this endpoint to retrieve **detailed information about accommodation orders**. Request → In the [orders/details/accommodations](/demand/docs/open-api/demand-api/orders/orders/details/accommodations) request, you must specify one of the following fields to identify the orders you want to retrieve: * `orders` - Retrieve data for specific order IDs (max 100) * `reservations` - Retrieve data for specific reservation IDs (max 100) **Optional fields:** * `currency` – Retrieve prices in a specific currency. * `extras` – Request additional details such as `accommodation_details`, `policies`, or `extra_charges`. * `language` – Return translated content for bundles in a specific language. Note: The `language` field does not retrieve all output translated. ```json { "currency": "USD", "extras": [ "accommodation_details", "policies", "extra_charges" ], "language": "fr", "reservations": [ "2444627607" ] } ``` Response The response returns an array of orders. For each order: * `id`– The order ID. * `accommodation` – Property ID; use [/accommodations/details](/demand/docs/open-api/demand-api/accommodations/accommodations/details) for more information. * `accommodation_details` – Name, email, location, and telephone of the property. * `cancellation_details` – Find here the cancellation `fee` charged, and the date/time of cancellation (null if not cancelled). * `checkin`/ `checkout` dates * `commission` – Breakdown of estimated/actual commission. * `pin_code` – Used by travellers for verification with customer support. * `price` – Order-level total and commissionable amounts. * `reservation` – Reservation ID. * `status` – Overall order status of the order (example: cancelled, booked, stayed, etc) * `products` – Array of product-level details (see below). **Product-level details:** * `allocation` – Number of adults and children (children ages listed individually). * `guest` - `name` and `email`. * `policies` – Cancellation, meal plan, and smoking preference. Note Cancellation policies are returned per product, not per order. This allows easier management of multi-room bookings where different policies apply. See the [cancellation policies section](/demand/docs/orders-api/cancellation-policies) for more details. * `price`- Base, display, and charges breakdown (when `extras=extra_charges` is requested). * `room` ID * `room_details` - Room `name` * `status` – Product status. Example: ```json { "request_id": "01fr9ez700exycb98w90w5r9sh", "data": [ { "id": "509430129718799", "accommodation": 123456, "accommodation_details": { "email": "test_hotel@booking.com", "location": { "address": "111 Street Road", "city": 20089219, "coordinates": { "latitude": 11.923274, "longitude": -92.716188 }, "country": "US", "post_code": "NY 1234" }, "name": "Test Booking Hotel USA", "telephone": "+19876543210" }, "cancellation_details": { "at": "2025-11-09T00:00:00+00:00", "fee": { "accommodation_currency": 170.01, "booker_currency": 186.87 } }, "checkin": "2025-11-10", "checkout": "2025-11-10", "commission": {...}, "pin_code": "1234", "price": {...}, "products": [...], "status": "booked" } ] } ``` ### Multi-room status precedence If different products within an order have different statuses, the `stayed` status takes precedence. This applies to both order and accommodation statuses. The status is displayed at both the accommodation and product levels in the response. ### Personally Identifiable Information (PII) When authorised, the response may include: * Guest `name` and `email`. * `booker.external_account`– Links the order to the partner system for loyalty points or rewards. ```json "booker": { "external_account": "13610217", "platform": "mobile" } ``` #### Conditions for returning external account id * Partner-specific configuration enabled. * Valid PII agreement in place. If not returned, either the setting is disabled or a valid PII agreement is missing. ## /orders/details/cars Use this endpoint to retrieve details of a car rental order. This endpoint follows a similar pattern to that used for accommodations. Request → In the [orders/details/cars](/demand/docs/open-api/demand-api/orders/orders/details/cars) request, specify one (and only one) of the following fields to define the car rental services for which you want to return information: * `orders` - Include the car rental order id to retrieve the data for the specified order. You can add one or several ids, to retrieve more car rental orders. * `reservations` - Alternatively you can use a reservation ID (or list of ids). **Optional fields:** * `currency` - To retrieve pricing in the desired currency. * `extras.policies` - To get the associated policies such as the payment timings. ```json { "currency": "EUR", "extras": ["policies"], "orders": ["123456789"] } ``` Details can be retrieved for orders up to one year old. Response Results are sorted by order creation date in descending order. For each order, the response returns: * `id` – Associated request ID. * `affiliate` - For partner identification in case commissions, etc. * `Currency` – Depot and booker currency. * `pick_up`/ `drop_off` dates and times. * `price` – Commissionable and total amounts. (Refer to [Accommodation pricing](/demand/docs/accommodations/prices-accommodations) section for more details) * `status`- Order status (see below) ```json { "request_id": "01jd57hf0kl8kj4nj6fpl8c5bf", "data": [ { "id": null, "affiliate": 1234567, "currency": { "depot": "EUR", "booker": null }, "drop_off": { "date_time": "2025-10-25T00:00:00+00:00" }, "label": "test-label-123456", "pick_up": { "date_time": "2025-10-20T00:00:00+00:00" }, "price": { "commissionable": null, "total": { "depot_currency": 108.40, "booker_currency": null } }, "products": { "price": { "base": null, "total": { "depot_currency": 108.40, "booker_currency": null } }, "status": "booked" }, "reservation": 123456789, "status": "booked" } ] } ``` ### Car rental statuses | Order status | Description | | --- | --- | | `cancelled` | The order has been cancelled and is no longer active. | | `confirmed` | The booking is confirmed by the supplier and is active. | | `not_confirmed` | The order request exists but has not yet been confirmed by the supplier. | | `quote` | A price quote has been generated; the booking has not been placed. | | `completed` | The rental has finished and the order is fully completed. Cannot be cancelled. | | `processing` | The booking is being processed; payment or final confirmation is pending. | | `unknown` | The booking status is unknown or not available. | ## /orders/details/flights Use this endpoint to retrieve details of a flight reservation order. Follows the same structure as accommodations and cars. Request → In the [orders/details/flights](/demand/docs/open-api/demand-api/orders/orders/details/flights) request, specify one of the following: * `orders` - Include the flight order id to get the data retrieved. You can add one or several ids, to get more flight orders. * `reservations` - Alternatively you can use a reservation ID (or list of ids). **Optional fields:** * `currency` - To retrieve pricing in the desired currency. ``` "currency": "EUR", ], "orders": [ 12345678895 ] ``` You can retrieve details for orders placed up to one year ago. Response For each order, the response returns the following information about flights: * `id` – Associated request ID. * `affiliate` – Partner ID. * `currency` – Booker and order currency. * `itineraries` – Departure/arrival details (time and airport). * `label` – Used for tracking affiliates or commissions. * `price` – Booker and order currency. (Refer to [Accommodation pricing](/demand/docs/accommodations/prices-accommodations) section for more details) * `status` – Order status: booked, cancelled, stayed, no-show. Check accepted airport codes via [common/location/airports](/demand/docs/open-api/demand-api/commonlocations/common/locations/airports) endpoint. ```json { "request_id": "01jeayp0a7v6abn2fsjhm3jdkt", "data": [ { "id": "ssdfugrjndknkgj", "currency": {"booker": "EUR", "order": "USD"}, "itineraries": [ { "departure": {"airport": "CAI", "date_time": "2025-03-01T07:00:00+00:00"}, "arrival": {"airport": "LXR", "date_time": "2025-03-01T08:10:00+00:00"} } ], "label": "hfebvjfbfbjkwbfgnkjrgn", "price": {"order_currency": 212.86, "booker_currency": 197.87}, "status": "booked" } ] } ``` ## Post-booking tasks Use `affiliate` id, `booker` details, `commission_details`, `loyalty_reward`, `price`, and `status` to: * Manage cancellations. * Report commissions to affiliates. * Allocate loyalty points or rewards. Curious to know more? * Learn about [accommodation pricing](/demand/docs/accommodations/prices-accommodations) and how you can display them in your application. * Make yourself familiar with the cancellation process checking the [Cancellations guide](/demand/docs/orders-api/cancel-order).