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

Create, read, and update reservations across all connected channels. Includes coupons, reservation fees, reservation units, host proxy email handling, and channel-of-origin context (channelId/channelName) for every booking.

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

This API exposes 1 JSON Schema definition.

Tagged areas include Vacation Rentals, Reservations, and Bookings. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, a JSON-LD context, and 1 JSON Schema.

This API exposes 4 operations across 2 paths, and defines 4 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.

4 operations 2 paths 4 schemas 2 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 Reservations 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 4

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

Reservations 4

Bookings and reservations across channels

GET
/reservations
Hostaway List Reservations
listReservations 6 params → 200
POST
/reservations
Hostaway Create Reservation
createReservation body → 200
GET
/reservations/{reservationId}
Hostaway Get Reservation
getReservation 1 param → 200
PUT
/reservations/{reservationId}
Hostaway Update Reservation
updateReservation 1 param body → 200

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are ReservationInput (17 properties), ReservationsResponse (5 properties), ReservationResponse (2 properties). Each schema is shown below with its type and property counts.

ReservationResponse
object
2 properties
Reservation
ReservationInput
object
17 properties 3 required
ReservationsResponse
object
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hostaway-reservations-api-openapi.yml Raw ↑

Other APIs Hostaway publishes across the network.

Hostaway Listings API
Hostaway Calendar 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