Welcome to the Hospitable Public API documentation!
Latest release of the Hospitable Public API, tagged
v2, allows you to manage calendars, reservations, properties, and more, in a programmatic way, using conventional HTTP requests.
Latest version of our API in a nutshell:
- JSON all the way
- authorisation via OAuth2 (and PAT for personal use)
- simple versioning via path prefix
- JSON superset via includes
The Hospitable API conforms to the REST Architectural Standards.
Entities are represented as resources, each one with an URL and unique identifier, and can be manipulated with the
DELETE HTTP methods. All methods except for the
POST are idempotent.
The API implements OAuth 2.0 authorisation standard.
A Hospitable User may authorise your application to make requests on their behalf.
As a Hospitable User, you may generate a Personal Access Token to make requests to the API yourself.
Resources versioning in the API follows the simple principle of version in the url, e.g.
v3/reservations. The data suggests this is the preferred approach by our API consumers, as clearer, easier to implement, and maintain in the future.
Certain endpoints allow including related Resources - look for
Allowed Includes in the documentation of each endpoint. This approach might be preferred to save you from making a multiple request to build the dataset you need.