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 Apartment API

The Apartment API from Holidu — 5 operation(s) for apartment.

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

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

This API exposes 6 operations across 5 paths, and defines 14 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.

6 operations 5 paths 14 schemas 3 GET1 POST2 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 Apartment 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 6

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

Apartment 6
PUT
/v2/apartment/deactivate
Deactivate apartment for provider
deactivateApartment 3 params → 202400401404500
PUT
/v2/apartment/activate
Activate apartment for provider
activateApartment 3 params → 202400401404500
GET
/v2/apartment
Get an apartment
getApartment 3 params → 200400401404500
POST
/v2/apartment
Create or update an apartment
upsertApartment 3 params body → 200400401500
GET
/v2/apartments/information
Get basic information about all apartments
getAllApartmentInformation 3 params → 200401500
GET
/v2/apartment/validation
Get validation result of apartment
getApartmentValidation 3 params → 200400401404418500

Schemas 14

The contract defines 14 schemas that model the data the API accepts and returns. The most detailed are CompleteApartmentDto (25 properties), BasicApartmentDto (23 properties), ApartmentValidation (5 properties), ApartmentInformationPage (4 properties). Each schema is shown below with its type and property counts.

ApartmentInformationPage
object
4 properties
HoliduErrorResponse
object
1 property
ValidationErrorMessage
object
Validation Error Messages
2 properties
OnRequestDetails
object
Used only for on request apartments
2 properties
CompleteApartmentDto
object
25 properties 4 required
ApartmentAddress
object
Address of the rental property
4 properties
CheckInDuration
object
List of possible check in times
2 properties 2 required
DuplicateFrom
object
Use this object if other Holidu partners also have this property in their system. Please contact us before using this.
2 properties
BasicApartmentDto
object
23 properties 4 required
ApartmentInformation
object
4 properties
ApartmentValidation
object
5 properties
GuestCapacityRules
object
Guest capacity rules applicable to apartment
4 properties 1 required
CheckInCheckOutTimes
object
Check-ins and check-outs details
2 properties 2 required
ContactDetails
object
Contact details
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

holidu-apartment-api-openapi.yml Raw ↑

Other APIs Holidu publishes across the network.

Holidu Availabilities API
Holidu Availability API
Holidu Booking Terms API
Holidu Bookings 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