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

Manage vacation rental listings — properties, amenities, bed types, images, and custom field values. Each Hostaway listing maps to one or more external channels (Airbnb, Vrbo, Booking.com, Expedia, Google Vacation Rentals, Marriott Homes & Villas) and is the primary inventory object in the platform.

Hostaway Listings 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, Listings, and Properties. 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 Listings 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.

Listings 4

Vacation rental listings and properties

GET
/listings
Hostaway List Listings
listListings 2 params → 200
POST
/listings
Hostaway Create Listing
createListing body → 200
GET
/listings/{listingId}
Hostaway Get Listing
getListing 1 param → 200
PUT
/listings/{listingId}
Hostaway Update Listing
updateListing 1 param body → 200

Schemas 4

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

Listing
ListingInput
object
20 properties
ListingsResponse
object
5 properties
ListingResponse
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hostaway-listings-api-openapi.yml Raw ↑

Other APIs Hostaway publishes across the network.

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