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

Holidu Bookings API

The Bookings API from Holidu — 3 operation(s) for bookings.

Holidu Bookings API is one of 23 APIs that Holidu publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

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

This API exposes 3 operations across 3 paths, and defines 18 schemas. It is described by OpenAPI 3.0.3, at version 1.1.0.

Requests are made against a single base URL, https://external-api.holidu.com.

3 operations 3 paths 18 schemas 1 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.1.0
Base URL
https://external-api.holidu.com
Authentication
API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Holidu Bookings API declares 2 security schemes for authenticating requests. An API key is passed in the header as x-api-key (ApiKeyAuth). It accepts HTTP bearer tokens (JWT) (BearerAuth).

  • BearerAuth — Holidu authenticates to the affiliate using an OAuth 2.0 Bearer Token ([RFC 6750](https://www.rfc-editor.org/rfc/rfc6750)). Token exchange details are agreed u…

Paths & Operations 3

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

Bookings 3
PUT
/v2/bookings
Update booking details
updateBooking 2 params body → 200400401403404418500
POST
/v2/bookings/cancel
Cancel a booking
cancelBooking 5 params → 200400401404418500
GET
/v2/bookings/details
Get booking details
getBookingDetails 3 params → 200400401404418500

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are BookingDetails (11 properties), CustomerDetails (10 properties), BookingUpsert (9 properties), BookingExtraCost (8 properties). Each schema is shown below with its type and property counts.

BookingExtraCost
object
8 properties
BookingCancellationResponse
object
1 property
CustomerDetails
object
Model of the Customer.
10 properties
Commission
object
2 properties
HoliduErrorResponse
object
1 property
BookingUpsertExtraCost
object
Breakdown of extra costs for the booking.
3 properties 2 required
Guest
object
1 property
PaymentRate
object
2 properties
Receipt
object
3 properties
BookingUpsert
object
9 properties 4 required
Payment
object
2 properties
PaymentWithBooking
object
5 properties
BookingDetails
object
11 properties
CancellationFee
object
2 properties
PriceDto
object
2 properties
Price
object
Price with amount and currency
2 properties 2 required
MetaData
object
7 properties
BookingDiscount
object
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

holidu-bookings-api-openapi.yml Raw ↑

Other APIs Holidu publishes across the network.

Holidu Apartment API
Holidu Availabilities API
Holidu Availability API
Holidu Booking Terms API
Holidu Changed API
Holidu Descriptions API
Holidu Details API
Holidu Discounts API
Holidu Extra Costs API
Holidu Facilities API
Holidu LOS API
Holidu LOS Push API API