Last updated

Changelog

Stay up to date with the latest enhancements to the Demand API.


September 2025

Highlights

✓ New free_stay in /accommodations/availability and accommodations/bulk-availability.

✓ Added support for reservations in /orders/details (cars, flights, accommodations) and /orders/details/flights.

Accommodation

/accommodation/availability and /accommodation/bulk-availability

| New | free_stay | /accommodations/availability and /accommodation/bulk-availability | version 3.1 |

A new boolean field, free_stay has been added to the maximum_occupancy.children object.

  • The free_stay field indicates whether children in a given age range can stay free of charge.
    • true - the child’s stay is free.
    • false- the cost is already included in the total price returned by the API.

This addition improves transparency by clearly signalling when a property allows children to stay free of charge.

Orders

/orders/details

| New | reservations array | /orders/details| version 3.1 |

You can now include a list of reservations either for cars, flights or accommodations, in the orders/details request.

This provides more accurate details for the specified reservations, regardless of the travel service.

Example request:

{
  "currency": "EUR",
  "reservations": ["728284398", "624244164"],
  "services": ["cars", "flights", "accommodations"]
}

/orders/details/flights

| New | reservations | /orders/details/flights| version 3.1 |

You can now include the reservation number in the orders/details/flights request.

  • This ensures accurate flight details are returned for that specific reservation.
  • The functionality is aligned with cars and accommodations, where either an order ID or a reservation ID can be used.

Example request:

{
 "currency": "USD",
  "reservations": [644906724]
}

Response:

{
    "request_id": "01k5xcs2sxjhn1ygksrv2cwm6m",
    "data": [
        {
            "id": "5024302678176842",
            "commission": {
                "actual_amount": {
                    "booker_currency": 2.49,
                    "order_currency": 2.00
                },
                "actual_percentage": 0.57,
                "estimated_amount": {
                    "booker_currency": 2.49,
                    "order_currency": 2.00
                }
            },
            "currency": {
                "booker": "USD",
                "order": "EUR"
            },
            "itineraries": [
                {
                    "departure": {
                        "airport": "SEN",
                        "date_time": "2025-09-12T13:00:00+00:00"
                    },
                    "arrival": {
                        "airport": "NQY",
                        "date_time": "2025-09-12T14:30:00+00:00"
                    }
                },
                {
                    "departure": {
                        "airport": "NQY",
                        "date_time": "2025-09-14T15:00:00+00:00"
                    },
                    "arrival": {
                        "airport": "LGW",
                        "date_time": "2025-09-14T16:20:00+00:00"
                    }
                }
            ],
            "label": "flights-booking-unknown",
            "price": {
                "booker_currency": 434.51,
                "order_currency": 413.86
            },
            "status": "booked",
            "reservation": 644906724 // Reservation id
        }
    ]
}

Bug fixes

EndpointSolution
/orders/createA bug that was causing failure in reserving accommodations located in Oman, Bahrain and other countries with pay_online_later has been fixed.
/orders/cancelA bug that was preventing cancelling accommodation reservations shortly before midnight on the day of checkin has been fixed.

References

Child policies guide

Learn more about children-adults occupancy, children rates and allocation, and see different use cases.

Read now

Order details guides

Learn how to get details about orders, including retrieving commission values, checking cancellation, and managing loyalty/rewards programmes.

Read now

Accommodation API reference

Check the accommodations/details endpoint specifications and give it a try in the console to return the new fields.

Check now

Orders API reference

See the orders/details endpoint specifications and give it a try in the console using the new field.

Check now