What’s new ?#

The “What’s New” section of our API documentation provides a comprehensive overview of the latest updates and enhancements to our system. We encourage you to regularly check this section to stay informed about our ongoing efforts to improve and expand our services.

New endpoint to retrieve the details of a booking done by a user through Amadeus Discover platform#

Delivery date – 2025 – week 13

New endpoint GET reporting/v1/bookings/{id} has been designed for API users who are willing to retrieve the booking details for a booking done by the user.

The endpoint returns the booking details of a booking made by the user matching the booking id provided as input parameter. Some of the details that can be retrieved would include: booking status, price information, cancellation details…

Find all details here: Booking Reporting


Enhanced Security with Client Grant Type Authentication#

Delivery date – 2025 – week 12

In our ongoing commitment to maintaining the highest security standards, we are transitioning from username and password grant type to client grant type for authentication. This change aligns with current best practices in API security and will provide a more efficient way to authenticate your requests.

What This Means for You:

  • Aligned with most recent security standards: Client grant type authentication fits state of the art of OAuth 2.1, ensuring a sustainable authentication framework

  • Ease of Use: This method simplifies the authentication process, allowing for smoother and more reliable API interactions.

Action Required: You can already benefit from this evolution and proceed with migration to client grant type now, with a minimal effort on your side. Please contact our onboarding team using discoverapi@amadeus.com to obtain client id and secret. The legacy password grant type will continue to be supported, with no decommission date planned for now. When a decommission is planned, we will announce it in advance and plan a proper migration plan.


New AI-Powered Endpoint for Top Activities#

Delivery date – 2025 – week 11

We are excited to introduce a new endpoint that leverages advanced AI to provide top activities for any given destination. This feature ensures that you expose the best must sees to travelers, increasing conversion rate. Our AI algorithms analyze vast amounts of data to curate the most popular and highly-rated activities, ensuring your users get the best experiences.

What This Means for You:

By integrating this endpoint, you can access in a single API call a list of up to 10 must see activities. This is especially powerful in the case there is no specific context about the traveler type or trip context. Displaying a relevant list of top activities will make the destination more appealing for any type of traveler. This endpoint is relying on our Recommendation Engine technology, enhanced with AI based analysis of top attractions in each destination. It only requires as input the destination (city name, IATA code or geolocation).

How to Use It:

The new endpoint is now available in all environments with the following path : GET /recommendation/v1/top-activities. You can find detailed information on how to integrate and use this feature in our updated API documentation


New endpoint to retrieve the list of all bookings done by a user through Amadeus Discover platform#

Delivery date – 2025 – week 11

New endpoint GET reporting/v1/bookings has been designed for API users who are willing to retrieve the list of all the bookings done by the user through Amadeus Discover platform.

The endpoint returns the list of all bookings made by the user matching some criteria like booking status, booking date or cancellation date for instance. By default it includes ALL bookings made by the user. Different filters can be applied as input parameter to obtain the desired list of bookings (e.g.: Confirmed bookings, Non Test bookings, Cancelled bookings…)

Find all details here: Booking Reporting


Refined Implementation Guidelines for Amadeus Discover Booking Flow#

We’ve updated the Amadeus Discover Booking Flow with refined steps to improve integration.

The process is now detailed in seven key steps: Availability, Options, Prices, Creation, Questions, Confirmation, and Post-Booking.

Each step has specific API endpoints, guiding users from retrieving availability and options, to pricing and booking confirmation, and finally, post-booking actions like retrieving vouchers or canceling a booking.

These new guidelines ensure seamless API integration and a smoother booking experience for Amadeus Discover products.


Announcement – new path for Recommendation Engine and Booking Flow endpoints#

Decommission date for old path : Dec 9th 2024

In the context of rationalization of Amadeus Discover API, new endpoints path are now available for Recommendation Engine endpoint and Booking Flow endpoints. If you are using the old paths, please make sure to migrate to the new path by December 9th 2024.

Only the path is modified, there is no change in the input or output structure of targeted endpoints.

Details

Recommendation Engine endpoint: 1 impacted endpoint

Old path : {base url}/api/consumer/v0/products/recommendations

New path : {base url}/recommendation/v1/products

Please refer to the dedicated page in this documentation for further details.

Booking Flow endpoints: 12 impacted endpoints

  • Step 1 : Get availability for a product

    Old path : {base url}/api/consumer/products/{productId}/availabilities

    New path : {base url}/booking-flow/v1/products/{productId}/availabilities

  • Step 1b : Get next existing availability for a product

    Old path : {base url}/api/consumer/products/{productId}/availabilities/next

    New path : {base url}/booking-flow/v1/products/{productId}/availabilities/next

  • Step 2a : Get options

    Old path : {base url}/api/consumer/products/{productId}/availabilities/{date}/options

    New path : {base url}/booking-flow/v1/products/{productId}/availabilities/{date}/options

  • Step 2b : Set options

    Old path : {base url}/api/consumer/products/{productId}/availabilities/{date}/options

    New path : {base url}/booking-flow/v1/products/{productId}/availabilities/{availabilityId}/options

  • Step 3a : Get Pricing

    Old path : {base url}/api/consumer/products/{productId}/availabilities/{availabilityId}/prices

    New path : {base url}/booking-flow/v1/products/{productId}/availabilities/{availabilityID}/prices

  • Step 3b : Set Pricing

    Old path : {base url}/api/consumer/products/{productId}/availabilities/{availabilityId}/prices

    New path : {base url}/booking-flow/v1/products/{productId}/availabilities/{availabilityID}/prices

  • Step 4 : Create Booking

    Old path : {base url}/api/consumer/bookings

    New path : {base url}/booking-flow/v1/bookings/

  • Step 5a : Get list of questions

    Old path : {base url}/api/consumer/bookings/{bookingId}/questions

    New path : {base url}/booking-flow/v1/bookings/{bookingId}/questions

  • Step 5b : Set list of questions/answers

    Old path : {base url}/api/consumer/bookings/{bookingId}/questions

    New path : {base url}/booking-flow/v1/bookings/{bookingId}/questions

  • Step 6 : Confirm booking

    Old path : {base url}/api/consumer/bookings/{bookingId}/confirm

    New path : {base url}/booking-flow/v1/bookings/{bookingId}/confirm

  • Step 7 : Get booking

    Old path : GET {base url}/api/consumer/bookings/{bookingId}

    New path : GET {base url}/booking-flow/v1/bookings/{bookingId}

  • Step 8 : Cancel Booking

    Old path : DELETE {base url}/api/consumer/bookings/{bookingId}

    New path : DELETE {base url}/booking-flow/v1/bookings/{bookingId}


Find the best products in each context with Recommendation Engine endpoint#

Delivery date – 2024 – week 25

The new recommendation engine endpoint provides a more efficient way to find the right products in the right context. Based on AI indexing of Amadeus Discover catalogue, this endpoint allows to provide a combination of Traveler Type, Trip Context, Risk level and Interests to find the most fitting products within Amadeus Discover platform.

With a high flexibility in combining criteria and context, this powerful feature covers several scenarios :

  • Find a set of products best fitting a context (Traveler Type, Trip Context, Risk level)

  • Find the best products for a given interest

  • Find top products for a destination

  • Find similar products

Check the dedicated documentation page and try it in the brand new Find and share Postman collection.

Booking Flow upgrade to handle client ID#

Delivery date – 2024 – week 12

The booking APIs have been updated to allow Customer Systems to associate bookings to a specific traveller via the externalClientID parameter.

Booking Flow now available on Consumer API!#

Delivery date – 2023 – week 51

A set of endpoints is now available to book products on Amadeus Discover platform with a single set of endpoints, no matter what is the Booking Engine behind. Booking Flow is initially enabled only for Holibob products, and will progressively be enriched with additional sources. Stay tuned! This feature is available to users with a special permission and require adaptations in the legal and commercial agreement with Amadeus Discover. Please contact us to engage onboarding on Booking Flow: discoverapi@amadeus.com.

More details (diagram flow and Postman Collection) in the dedicated section Booking flow

Change detection endpoint now includes undeprecated products#

Delivery date – 2023 – week 50

The change detection endpoint is now fully ready to be operated as it now covers all cases of change, including newly undeprecated elements. With this evolution, an optimized flow is now available to source and keep up-to-date a subset of Amadeus Discover Platform content. A first full import is necessary (that can include many filters to only source a part of Amadeus Discover content), and then a regular call to change detection endpoint with same search criteria allows to detect elements that changed : New products, Updates products, Deleted products, Deprecated products, undeprecated products. Users can now have more discernment in updating content coming from Amadeus Discover More details in the dedicated section Search Product Information (change detection / diff version)

Endpoint to detect new / updated products in Amadeus Discover platform#

Delivery date – 2023 – week 32

New endpoint GET /api/consumer/diff/products has been designed for API users who are willing to import a part of Amadeus Discover catalogue and keep it up-to-date. It replicates the same capabilities and search criteria as the search product endpoint (search per title, taxonomy, country, geography…), including as input a date.

The endpoint returns the list of products matching the search criteria and that have been updated in the catalogue since provided date. By default it includes ALL changes types : NEW products, UPDATED products and DELETED products. It can be filtered as part of changetype input parameter.

NB : the output currently does not include the products that have been DEPRECATED, PROMOTED or BLACKLISTED in the requested timeframe.

Find all details here: Search Product (change detection / diff version).