Check 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	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	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	Returns the flight information included in an order.	✓ Provide travellers with details about a specific flight order. ✓ Check order status.

/orders/details/accommodations

Use this endpoint to retrieve detailed information about accommodation orders.

→ In the orders/details/accommodations request, specify only one out of the following fields to identify the orders you want to retrieve:

orders - Retrieve data for specific order IDs.
reservations - Retrieve data for specific reservation IDs.
Use this option if you need to access bookings created using Demand API v2, for which you do not have an order id. For more information, see "bookingDetails - V3 migration guide".

Optional fields:

currency – Retrieve prices in a specific currency.
extras – Request additional details such as accommodation_details, policies, or extra_charges.

{
  "currency": "USD",
  "extras": [
    "accommodation_details",
    "policies",
    "extra_charges"
  ],
  "reservations": [
    2444627607
  ]
}

Note

You can retrieve details for orders or reservations placed up to 1 year ago.

Personally Identifiable Information (PII)

When authorised, the response includes:

Guest name and email.
external_account– Links the accommodation order to the partner’s system for loyalty points or rewards.
```
  "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.

→ In the 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.

{
  "currency": "EUR",
  "extras": ["policies"],
  "orders": ["123456789"]
}

Details can be retrieved for orders up to one year old.

/orders/details/flights

Use this endpoint to retrieve details of a flight reservation order. Follows the same structure as accommodations and cars.

→ In the 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
]
```
Note
You can retrieve details for orders placed up to one year ago.

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 and how you can display them in your application.
Make yourself familiar with the cancellation process checking the Cancellations guide.

Check travel services details in an order

Overview

/orders/details/accommodations

Personally Identifiable Information (PII)

Conditions for returning external account id

/orders/details/cars

/orders/details/flights

Post-booking tasks

Was this helpful?