Amadeus Hotel Booking

Name: Hotel Booking API
Brand: Hotel Booking
Availability: InStock

✓ 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.

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.

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 | sh

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 instance

Jentic 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

GET STARTED

Start building with Hotel Booking API

Explore with Jentic

View OpenAPI Document

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.

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.