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

You can use the following endpoints to get information about different travel services orders:

Endpoint	Action	Use it to...
/orders/details/accommodations	Retrieves information about the accommodation-specific part of the order.	✓ Provide details to a customer about 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 information to a customer about a specific car rental order. ✓ Check order status.
/orders/details/flights	Returns the flight information included in an order.	✓ Provide information to a customer about a specific flight order. ✓ Check order status.

/orders/details/accommodations

Use this endpoint to retrieve details of an accommodation listed in a specific order.

→ In the orders/details/accommodations request, specify only one out of the following fields to define the orders for which you want to return information:

orders - Get the data for the specified order(s).
reservations - Get the data for the specified reservation(s).
Use this option only 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".
Note
You can retrieve details for orders or reservations placed up to 1 year ago.
All other fields are optional.
```
  "currency": "USD",
  "extras": [
        "accommodation_details",
        "policies",
        "extra_charges"
  ],
  "reservations": [
    2444627607
    ]
```

Personally Identifiable Information (PII)

When a partner is authorised to access the Personally Identifiable Information (PII) then, the orders/details/accommodations response returns the following information:

The guest name and email to whom the room is allocated.
The external_account_id: This is a unique identifier that represents the account ID in the supply partner's system.

External account id

This field is used to link a specific accommodation order to the corresponding account in the partner's system. It enables the accurate allocation of loyalty points or other benefits in the partner's loyalty and rewards programs.

  ],
  "booker": {
    "external_account": 13610217,
    "platform": "mobile"
  },

Conditions for return the external_account_id:

Partner-specific setting:
- This field is conditionally returned based on a configuration in the partner’s admin settings.
- If the partner has enabled this setting, the external_account_id will be included in the response.
PII Agreement:
- The external_account_id will only be included if the partner has a valid Personal Identifiable Information (PII) agreement in place.
- This ensures that the inclusion of the account ID complies with privacy and data protection policies.

Format:

A string that uniquely identifies the account within the partner's system.
The format and length of the identifier may vary depending on the partner system configuration.

If the external_account_id is not included in the response, it indicates that either the setting has not been enabled by the partner, or a valid PII agreement is not in place.
The presence of external_account_id enables partners to link bookings to their internal systems for rewards processing.

/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:

order - 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.
reservation - Alternatively you can use a reservation ID (or list of ids) to filter data for the specified reservation(s), when you do not have an order id.
Note
You can retrieve details for orders or reservations placed up to one year ago.

Optionally, you can also pass:

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"
]
}

/orders/details/flights

Use this endpoint to retrieve details of a flight reservation order. This endpoint follows a similar pattern to that used for accommodations and cars.

→ In the orders/details/flights request, specify the following fields:

order - Include the flight order id to get the data retrieved. You can add one or several ids, to get more flight orders.

Optionally, you can also pass:

currency - To retrieve pricing in the desired currency.
Note
You can retrieve details for orders placed up to one year ago.
```
"currency": "EUR",
],
"orders": [
  12345678895
]
```

Post-booking tasks

You can use the affiliate id, booker details, commission_details, loyalty_reward, price, and status to perform different post-booking tasks, like cancellations or reporting the commission due to your affiliates for new orders.

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.