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

Hotelbeds Booking API

The Booking API from Hotelbeds — 5 operation(s) for booking.

Hotelbeds Booking API is one of 5 APIs that Hotelbeds publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Booking. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 7 operations across 5 paths, and defines 7 schemas. It is described by OpenAPI 3.0.1, at version 1.0.

Requests are made against 2 base URLs: https://api.hotelbeds.com, https://api.test.hotelbeds.com.

7 operations 5 paths 7 schemas 1 DELETE3 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0
Base URL
https://api.hotelbeds.com/hotel-api/1.0
Authentication
API Key, API Key
Terms of Service
Resource Areas
1

Authentication & Security 2

Hotelbeds Booking API declares 2 security schemes for authenticating requests. An API key is passed in the header as Api-key (ApiKeyAuth). An API key is passed in the header as X-Signature (SignatureAuth). By default, every request must be authenticated.

  • ApiKeyAuth — Your APItude API key, issued per API suite (Hotel, Activities, Transfers).
  • SignatureAuth — SHA256 hash, in hexadecimal, of the concatenation of the API key, the shared secret, and the current Unix timestamp in seconds.

Paths & Operations 7

Across 5 paths, the API surfaces 7 operations — 1 DELETE, 3 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Booking 7
GET
/hotel-api/1.0/status
API status check
getStatus → 200
POST
/hotel-api/1.0/hotels
Hotel availability search
getAvailability body → 200
POST
/hotel-api/1.0/checkrates
Check rates
checkRates body → 200
GET
/hotel-api/1.0/bookings
List bookings
listBookings 2 params → 200
POST
/hotel-api/1.0/bookings
Confirm a booking
confirmBooking body → 200
GET
/hotel-api/1.0/bookings/{bookingId}
Booking detail
getBookingDetail 1 param → 200
DELETE
/hotel-api/1.0/bookings/{bookingId}
Cancel a booking
cancelBooking 2 params → 200

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are Hotel (6 properties), Booking (5 properties), AvailabilityRequest (3 properties), BookingRequest (3 properties). Each schema is shown below with its type and property counts.

AvailabilityResponse
object
2 properties
CheckRateRequest
object
1 property
Booking
object
5 properties
BookingRequest
object
3 properties
Hotel
object
6 properties
Status
object
1 property
AvailabilityRequest
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hotelbeds-booking-api-openapi.yml Raw ↑

Other APIs Hotelbeds publishes across the network.

Hotelbeds Activities API
Hotelbeds Cache API
Hotelbeds Content API
Hotelbeds Transfers API