Skip to main content
Two endpoints fetch reference hotel data directly. Use the single-hotel endpoint to look up a known hotel by its UUID. Use the presigned URL endpoint to download the complete inventory file for bulk ingestion, offline processing, or building your own index.

​
GET /api/v1/reference/

Retrieve full detail for a single reference hotel by its UUID.

​
Path parameters

​
string
required
The UUID of the reference hotel.

​
Response

​
string
required
Hotel UUID.
​
string
required
Hotel display name.
​
string
Country name.
​
string
City name.
​
string
Region or state.
​
number
Star rating.
​
number
Latitude coordinate, if available.
​
number
Longitude coordinate, if available.
​
object
Additional hotel metadata and embeddings.

​
Errors

​
Example

​
GET /api/v1/reference

Get a presigned URL to download the latest reference hotel inventory file.
This endpoint requires authentication. Requests without a valid X-API-Key header return 401 Unauthorized.
The presigned URL grants temporary access to the full reference inventory. Download the file directly with any HTTP client, no additional authentication needed. The URL expires after the number of minutes you specify.

​
Query parameters

​
number
default:"60"
How many minutes the presigned URL remains valid. Defaults to 60.

​
Response

​
string
required
Presigned URL for downloading the reference inventory file directly. Valid for expirationMinutes minutes. No additional X-API-Key header is needed when fetching this URL.

​
Errors

​
Example

Download the inventory file in the background and cache it locally. Re-request a new presigned URL only when your cached copy is stale rather than on every lookup.