Amadeus Hotel Booking
Browse all Amadeus APIs✓ Official Vendor SpecE CommerceOrder Managementoauth21 EndpointsREST
For Agents
Create a real hotel reservation from a confirmed Amadeus hotel offer, returning provider confirmation numbers an agent can hand back to the traveller.
Use for: Book the hotel offer the user just confirmed, Create an Amadeus hotel reservation for two guests, I want to confirm a hotel booking with credit card payment, Submit guest details and payment to book a hotel
Not supported: Does not search hotels, manage cancellations, or capture payment outside the provider's own flow — use only to create a hotel reservation from a confirmed Amadeus hotel offer.
The Amadeus Hotel Booking API turns a confirmed hotel offer into a real reservation with the underlying hotel provider. The single POST endpoint takes an offer id from Hotel Search, traveller and guest details, plus payment information, and returns one or more booking ids and provider confirmation numbers. It is the final step in the Self-Service hotel flow and submits real reservations against live hotel inventory, so test bookings should never run against the production environment.
Install Jentic One Beta
Connect the Hotel Booking to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Hotel Booking, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Hotel Booking API.
Create a hotel reservation from a confirmed Amadeus hotel offer id
Submit guest names, contact details, and payment information in a single call
Return provider confirmation numbers and the Amadeus booking id for the reservation
Support multi-room bookings on the same offer in one request
Handle credit card payment information per provider requirements
Use Cases
Patterns agents use Hotel Booking API for, with concrete tasks.
★ Confirm a Hotel Reservation End-to-End
After a user picks a hotel offer from Hotel Search, the integrator posts the offer id together with guest details and payment information to /booking/hotel-bookings. The response includes the Amadeus booking id and the provider's confirmation number, which the integrator stores and shows on the confirmation page.
POST a confirmed hotel offer with one guest (name, email, phone) and credit card details to /booking/hotel-bookings and return the Amadeus booking id and provider confirmation.
Multi-Room Family Booking
Travel agencies booking two adjoining rooms for a family submit a single hotel-bookings call with the matching offer ids and one set of guest details per room. The response carries one booking id per room together with provider confirmations, simplifying the manage-booking experience.
Create two hotel bookings on the same property by submitting two offer ids and per-room guest details in a single call to /booking/hotel-bookings.
Corporate Travel Hotel Reservation
Corporate booking tools call Hotel Booking with the corporate traveller's profile data and a corporate credit card token issued by the integrator's PSP. The Amadeus booking id and provider confirmation are written to the traveller's expense record and the on-property folio is reconciled later via the corporate program.
Book a single-night hotel stay for a corporate traveller in NYC using a stored offer id and a tokenised corporate card.
Agent-Driven Hotel Booking via Jentic
An AI travel concierge that searches Amadeus hotel inventory uses Jentic to call the Hotel Booking endpoint once the user confirms. Jentic resolves OAuth and validates the offer, guest, and payment payload against the operation schema, returning the booking id the agent can show the user.
Call jentic.search('book an Amadeus hotel offer'), load the operation, and execute it with offerId, guests, and payments to return the Amadeus booking id.
Key Endpoints
1 endpoints — the amadeus hotel booking api turns a confirmed hotel offer into a real reservation with the underlying hotel provider.
METHOD
PATH
DESCRIPTION
POST
/booking/hotel-bookings
Create a hotel reservation from a confirmed offer
POST
/booking/hotel-bookings
Create a hotel reservation from a confirmed offer
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Amadeus client_id and client_secret are stored encrypted in the Jentic vault. Jentic runs the OAuth 2.0 client_credentials exchange and refreshes the bearer token automatically before each booking call, so the agent never handles raw secrets.
Intent-based discovery
Agents search Jentic by intent ('book an Amadeus hotel offer') and Jentic returns the /booking/hotel-bookings operation with its required offerId, guests, and payments shapes.
Time to first call
Direct Amadeus integration: 3-5 days for OAuth, payload shaping, and provider confirmation handling. Through Jentic: under 1 hour — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Hotel Booking API through Jentic.
What authentication does the Hotel Booking API use?
Amadeus Self-Service OAuth 2.0 client_credentials. Exchange your client_id and client_secret at https://api.amadeus.com/v1/security/oauth2/token for a bearer token and pass it in the Authorization header. Through Jentic, the credentials live in the encrypted vault and the bearer token is rotated for you on each call to /booking/hotel-bookings.
Should I use this API in the test environment for live testing?
No — Amadeus warns against running test bookings against production, since real reservations are sent to hotel providers and excessive cancellations can get an integrator blacklisted. Use the test base host (test.api.amadeus.com) with sample offer ids during development.
What are the rate limits for the Hotel Booking API?
Amadeus Self-Service Test environment caps booking endpoints at 1 transaction per second per API key with a monthly quota; Production limits scale with your Self-Service plan tier. Bearer tokens themselves expire after roughly 30 minutes.
How do I create a hotel booking through Jentic?
Run pip install jentic, then call jentic.search('book an Amadeus hotel offer'), load the operation, and execute it with offerId, guests, and payments. Jentic posts to /booking/hotel-bookings and returns the Amadeus booking id and provider confirmation.
Does this API charge the guest's credit card?
Card details submitted here are forwarded to the hotel provider for processing under the offer's payment policy (deposit, full charge, or pay-at-property). The integrator should still tokenise card data through its own PSP for storage and PCI scope, rather than persisting raw card numbers.
How do I cancel a hotel booking I just created?
Cancellation is not part of this API. Use the hotel provider's cancellation flow via the confirmation number returned in the booking response, or the Amadeus Self-Service Hotel Order Management endpoints if your account has access.
GET STARTED