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

HotelRunner Reference Data API

Read-only lookup data used for property and integration setup.

HotelRunner Reference Data API is one of 4 APIs that HotelRunner publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Reference Data. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 8 operations across 8 paths, and defines 1 schema. It is described by OpenAPI 3.0.3, at version v2.

Requests are made against 2 base URLs: https://app.hotelrunner.com/api/v2/apps, https://app.hotelrunner.com.

8 operations 8 paths 1 schemas 8 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
v2
Base URL
https://app.hotelrunner.com/api/v2/apps
Authentication
API Key
Resource Areas
1

Authentication & Security 1

HotelRunner Reference Data API declares 1 security scheme for authenticating requests. An API key is passed in the query as token (tokenAuth). By default, every request must be authenticated.

  • tokenAuth — API token issued in the property's HotelRunner Partners extranet ("My Property" section) or PMS sandbox account. Always sent together with the hrid query param…

Paths & Operations 8

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

Reference Data 8

Read-only lookup data used for property and integration setup.

GET
/api/property/types.json
Get property kinds
getPropertyKinds → 200
GET
/api/room/types.json
Get room kinds
getRoomKinds → 200
GET
/api/currency/currencies.json
Get currencies
getCurrencies → 200
GET
/services/get-property-services
Get property services
getPropertyServices → 200
GET
/services/get-property-facilities
Get property facilities
getPropertyFacilities → 200
GET
/services/get-room-amenities
Get room amenities
getRoomAmenities → 200
GET
/services/country-codes
Get country codes
getCountryCodes → 200
GET
/services/channel-list
Get channel list
getChannelList → 200

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. Each schema is shown below with its type and property counts.

IdNameList
object
Modeled as an id-to-name map per HotelRunner's own description of these endpoints ("id-name mapping"); HotelRunner's docs did not show a literal example payloa…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hotelrunner-reference-data-api-openapi.yml Raw ↑

Other APIs HotelRunner publishes across the network.

HotelRunner Channels API
HotelRunner Inventory API
HotelRunner Reservations API