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

Hostaway Calendar API

Read and update the per-listing availability and nightly pricing calendar. Supports per-day retrieval, batch updates across date ranges, and inline reservation context via the includeResources query parameter.

Hostaway Calendar API is one of 16 APIs that Hostaway publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Vacation Rentals, Calendar, Availability, and Pricing. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

This API exposes 3 operations across 2 paths, and defines 3 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.hostaway.com/v1.

3 operations 2 paths 3 schemas 1 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Server
https://api.hostaway.com/v1
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Hostaway Calendar API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2ClientCredentials) using the clientCredentials flow, exposing 1 scope. By default, every request must be authenticated.

Paths & Operations 3

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

Calendar 3

Listing calendar availability and pricing

GET
/listings/{listingId}/calendar
Hostaway Get Calendar Days
getCalendarDays 4 params → 200
PUT
/listings/{listingId}/calendar
Hostaway Update Calendar Day
updateCalendarDay 1 param body → 200
POST
/listings/{listingId}/calendar/batch
Hostaway Batch Update Calendar
batchUpdateCalendar 1 param body → 200

Schemas 3

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

CalendarDay
CalendarResponse
object
2 properties
CalendarDayInput
object
8 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hostaway-calendar-api-openapi.yml Raw ↑

Other APIs Hostaway publishes across the network.

Hostaway Listings API
Hostaway Reservations API
Hostaway Messaging API
Hostaway Finance API
Hostaway Tasks API
Hostaway Custom Fields API
Hostaway Guest Payments API
Hostaway Reference Data API
Hostaway Webhooks API
Hostaway Listing Amenities API
Hostaway Listing Bed Types API
Hostaway Listing Images API