For Agents
Search hotels, fetch room types and rates, and manage hotel bookings. Useful for travel marketplaces and AI travel agents.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Impala Hotel Bookings API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# 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.
What an agent can do with Impala Hotel Bookings API API.
Search hotels by destination and date range
Retrieve detailed hotel content including amenities and imagery
Pull available room types for a specific hotel
Fetch rates and availability for date ranges
GET STARTED
Use for: I want to search hotels in Madrid for next month, Get all room types available at a specific hotel, Retrieve rates and availability for a hotel, Create a booking for two guests
Not supported: Does not handle flights, payments outside the booking flow, or activities - use for hotel search, rates, and booking lifecycle only.
The Impala Hotel Bookings API v2 is a streamlined hotel content, rates, and bookings interface from Impala. Across 8 endpoints it covers hotel search, hotel detail, room types, rates and availability, plus booking creation, retrieval, and cancellation. Authentication uses an x-api-key header. The v2 surface is smaller and more uniform than v1, making it the preferred starting point for new travel marketplace and concierge integrations.
Create a hotel booking with guest details
Retrieve and cancel bookings via dedicated endpoints
Patterns agents use Impala Hotel Bookings API API for, with concrete tasks.
★ Travel Marketplace Hotel Search
Add hotel search and booking to a travel marketplace using the Impala Hotel Bookings v2 surface. The hotels and rates endpoints expose a uniform schema across thousands of properties so the marketplace does not need to integrate with individual channel managers.
Search hotels for 'Madrid' between 2026-08-10 and 2026-08-12, fetch the lowest-rate room type for the top result, and create a booking for one guest.
AI Concierge with Hotel Booking
Power AI concierge experiences that recommend and book hotels via natural language. The agent calls the search and rates endpoints to compare options and books the chosen hotel through POST /bookings, returning a confirmation reference to the user.
Given a user request 'book a hotel in Lisbon under 150 EUR for two nights starting 2026-09-01', search hotels, pick the cheapest available room type, and confirm the booking on user approval.
Cancellation Self-Service
Customer self-service flows can use POST /bookings/{bookingId}/cancel to cancel an existing reservation without operator intervention. The agent looks up the booking, confirms the cancellation policy attached to the rate, and triggers cancellation in one call.
Cancel booking BKG-44521 and return the cancellation confirmation id to the support ticket.
Jentic-Driven Trip Planner
Expose Impala v2 to Jentic so a trip-planning agent can search hotels, fetch room types, and create bookings without learning the OpenAPI spec. The agent uses Jentic intent search to locate each operation and Jentic injects the x-api-key at runtime.
Plan a 3-night Lisbon trip: search hotels, list available room types for the top match, and create a booking for two guests with check-in 2026-10-04.
8 endpoints — the impala hotel bookings api v2 is a streamlined hotel content, rates, and bookings interface from impala.
METHOD
PATH
DESCRIPTION
/hotels
Search hotels
/hotels/{hotelId}
Get hotel details
/hotels/{hotelId}/room-types
Get room types for a hotel
/hotels/{hotelId}/rates
Get rates and availability
/bookings
Create a booking
/bookings/{bookingId}
Get a booking
/bookings/{bookingId}/cancel
Cancel a booking
/hotels
Search hotels
/hotels/{hotelId}
Get hotel details
/hotels/{hotelId}/room-types
Get room types for a hotel
/hotels/{hotelId}/rates
Get rates and availability
/bookings
Create a booking
Three things that make agents converge on Jentic-routed access.
Credential isolation
Impala API keys are stored encrypted in the Jentic vault. Agents call the API with a scoped Jentic token and the raw x-api-key never enters the agent context.
Intent-based discovery
Agents search Jentic by intent such as 'search hotels' or 'create a booking' and Jentic returns the matching Impala v2 operations with input schemas.
Time to first call
Direct Impala v2 integration: 1-2 days for auth, search, and booking error paths. Through Jentic: under an hour. Search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Impala Hotel Booking API v1
Earlier v1 surface from Impala with rate calendar and payment JWT flow
Choose v1 only when integrating with an existing v1 client or when you need the explicit rate calendar endpoints.
Booking.com
Large OTA with broad hotel inventory and affiliate booking flow
Choose Booking.com when reach matters more than direct commission and white-label experience control.
Cloudbeds
Property management system useful for hoteliers receiving reservations
Use Cloudbeds on the property side to receive and manage Impala-originated reservations in the hotel's PMS.
Specific to using Impala Hotel Bookings API API through Jentic.
What authentication does the Impala Hotel Bookings API use?
The API uses an x-api-key header issued from your Impala account. Through Jentic, the key is stored in the encrypted vault and the agent receives a scoped Jentic token, so the raw key never enters the agent context.
Can I search hotels by destination with this API?
Yes. GET /hotels accepts search parameters and returns a list of hotels. You can then call GET /hotels/{hotelId} to pull content, GET /hotels/{hotelId}/room-types for inventory, and GET /hotels/{hotelId}/rates for pricing.
What are the rate limits for the Impala Hotel Bookings API?
The published spec does not state explicit rate limit numbers. Impala throttles per-account, so agents should monitor for 429 responses and back off, especially when running large search sweeps across multiple destinations.
How do I create a hotel booking through Jentic?
Search Jentic for 'create a hotel booking' to surface the operation backed by POST /bookings on this v2 API. Load the schema, pass hotelId, room type, guest details, and dates, then execute. Jentic injects the x-api-key at runtime.
How do I cancel a booking through this API?
Call POST /bookings/{bookingId}/cancel with the booking id. The response confirms cancellation; refund treatment is determined by the rate's cancellation policy at the time of booking.
Should I use v1 or v2 of the Impala booking surface?
Prefer v2 for new builds. It has a smaller, more uniform set of endpoints and uses a simple x-api-key flow. Use v1 only when maintaining an existing integration that depends on the v1 rate plan model.
/bookings/{bookingId}
Get a booking
/bookings/{bookingId}/cancel
Cancel a booking