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 Extra Costs API

The Extra Costs API from Holidu — 1 operation(s) for extra costs.

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

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

This API exposes 2 operations across 1 path, and defines 6 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.

2 operations 1 paths 6 schemas 1 GET1 POST

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 Extra Costs 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 2

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

Extra Costs 2
GET
/v2/apartments/extracosts
Get the extra costs of an apartment
getExtraCosts 3 params → 200401404500
POST
/v2/apartments/extracosts
Update the extra costs of an apartment
updateExtraCosts 3 params body → 200401404500

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are ApartmentExtraCost (8 properties), ExtraCostPrice (3 properties), SeasonApplicable (2 properties), ExtraCostCondition (2 properties). Each schema is shown below with its type and property counts.

LengthOfStay
object
Extra cost only applicable if lengthOfStay shorter than
2 properties
ExtraCostPrice
object
Price configuration for extra cost
3 properties 2 required
HoliduErrorResponse
object
1 property
ApartmentExtraCost
object
8 properties 6 required
ExtraCostCondition
object
Conditions applicable for extra cost
2 properties
SeasonApplicable
object
Season for which extra cost is applicable
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

holidu-extra-costs-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 Bookings API
Holidu Changed API
Holidu Descriptions API
Holidu Details API
Holidu Discounts API
Holidu Facilities API
Holidu LOS API
Holidu LOS Push API API