ORDERS
/
Run order reports
/
Post-booking Travel services details
Last updated

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/accommodationsRetrieves 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/carsRetrieves 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/flightsReturns 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.

→ In the 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 example policies or accommodation details) in a specific language.
{
  "currency": "USD",
  "extras": [
    "accommodation_details",
    "policies",
    "extra_charges"
  ],
  "language": "en",
  "reservations": [
    "2444627607"
  ]
}

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.
"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?
Previous page
Next page