Introduction

The Hotel Data API is a platform to allow the retrieval of system data including, Deployments, Transactions and Documents. The API exposes a series of REST endpoints as well as a Webhook system for real time notifications of specific events.

Authentication

See Authentication for details on how to obtain and manage Access tokens, using the PKN of HOTELDATAAPI.

Endpoint Types

The REST endpoints are split into two contexts, Search endpoints and Direct endpoints.

Search Endpoints

These are endpoints that allow search criteria to be provided and will filter down the records returned by this criteria. Unless otherwise stated search criteria is inclusive.

The data returned from these endpoints is paginated and a summary of the data. For details results use the Direct Endpoints to request more detailed information on individual resources.


ℹ️ All search endpoints are POST requests.


/v1/Documents to search for Documents or /v1/Transactions to search for Transactions.

Direct Endpoints

These are endpoints where you know the entity you wish to retrieve, by id. You can request this Entity directly or request Child entities related to it.

Direct Endpoints also require the Card Pool Id via query string that the request resource belongs to.

/v1/Deployments/123 to request a specific Deployment or /v1/Deployments/123/invoices to request the invoices related to that Deployment.