Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Impala Hotels API

Accessing hotel content, available rooms and rates.

Impala Hotels API is one of 3 APIs that Impala publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Hotels. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 2 operations across 2 paths, and defines 19 schemas. It is described by OpenAPI 3.0.0, at version 1.003.

Requests are made against 2 base URLs: https://sandbox.impala.travel/v1, https://api.impala.travel/v1.

2 operations 2 paths 19 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.003
Base URL
https://api.impala.travel/v1
Authentication
API Key, HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 2

Impala Hotels API declares 2 security schemes for authenticating requests. An API key is passed in the header as x-api-key (API_Key_Authentication). It accepts HTTP bearer tokens (JWT) (paymentAuth). By default, every request must be authenticated.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Hotels 2

Accessing hotel content, available rooms and rates.

GET
/hotels
List all hotels
listHotels 14 params → 200400401500
GET
/hotels/{hotelId}
Retrieve a hotel
retrieveHotel 3 params → 200400401403500

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are hotelFullDetail (22 properties), rate (12 properties), address (7 properties), roomType (7 properties). Each schema is shown below with its type and property counts.

money
object
An amount of money in the specified currency (used in the context of prices, fees, refunds etc.)
2 properties 2 required
rate
object
Information on the price of the room, other components of the room (such as breakfast, lunch or a welcome drink) and the cancellation policies that apply.
12 properties 9 required
roomType
object
Bookable category of bookable rooms within a hotel
7 properties 6 required
address
object
Physical address
7 properties 5 required
amenity
object
Feature or facility available in the hotel or room type. For the full list of property and room amenity codes, you can click on the "Room Amenities" and "Prope…
2 properties 2 required
hotelFullDetail
object
Full details on a hotel, including its room types and available rates
22 properties 18 required
validationError
rateComponent
object
Product or service offered as part of a rate in addition to accommodation in the room.
3 properties 2 required
cancellationPolicy
object
A rule that applies if the booking is cancelled.
4 properties 3 required
cancellationFee
object
Describes the costs associated with a cancellation and how it is calculated.
3 properties 2 required
hotelAgreementStub
object
Essential information on an agreement with a hotel.
7 properties 3 required
taxOrFee
object
Details of a tax or fee (included or excluded in a rate).
3 properties
pagination
object
Information that helps paginate through lists of resources.
4 properties 4 required
validationResult
object
Describes the validation that failed.
3 properties 2 required
location
object
Precise location on a map (using WGS 84 longitude and latitude notation)
2 properties 2 required
timeRange
object
A time range. Open-ended time ranges are indicated by omitting either start or end in the object.
2 properties
image
object
4 properties 3 required
genericError
object
2 properties 1 required
externalUrl
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

impala-hotels-api-openapi.yml Raw ↑

Other APIs Impala publishes across the network.

Impala Bookings API
Impala Rate Calendar API