Developer portalHMS Hotel Software

Connect your software to HMS modules

Separate API documentation for every module of the hotel software: booking engine, guest Wi-Fi, restaurant POS, spa, TV, PBX and AI services. The Online Booking and Hotspot APIs are live now; the others follow.

Authentication
Bearer token or ApiKey header
Format
JSON responses, success envelope
Live
2 products · 17 endpoints
Coming soon
5 products
Request
# Room and rate query
curl "https://test.hms.gen.tr/external/online/roomType" \
  -H "Authorization: Bearer $HMS_TOKEN" \
  -d "hotelID=1000" -d "startDate=2026-08-18" -d "endDate=2026-08-20" \
  -d "adultCount=2"
Response · 200 (truncated)
{
    "success": true,
    "items": [
        {
            "id": 2,
            "name": "Standard Room",
            "roomCount": 5,
            "currency": "TRY",
            "accommodationTypes": [
                {
                    "id": 2,
                    "title": "Bed & Breakfast",
                    "prices": {
                        "2-1": {
                            "total": 2,
                            "price": "1930.00",
                            "nonRefundable": ""
                        },
                        "2-0": {
                            "total": 2,
                            "price": "1737.00",
                            "nonRefundable": "[NR]"
                        }
                    }
                }
            ]
        }
    ],
    "count": 1
}

Principles shared by all products

Once you have integrated one module, the others will feel familiar.

Hotel-bound key

In Online Booking, the apiKey/apiSecret issued by HMS is exchanged for a hotel-bound Bearer token valid for 7 days. On-premise integrations such as Hotspot use a key generated in the hotel’s own panel, sent as an ApiKey header on every request.

Authentication

success envelope

Responses are JSON and carry a success flag. Business-rule errors come back as HTTP 200 with message or errorCode; authentication errors are 401.

Requests and responses

Working samples

cURL, Node.js and PHP samples are generated for every endpoint; copy them, add your key and run.

API reference

Recent changes

Full changelog

  • Hotspot
    Hotspot API documentation published
    NewNew
  • Online Booking
    Online Booking API documentation published
    NewNewNew
  • Site
    hmsdev.com launched
    New

Stuck?

Our developer team replies within one business day.

Include the request body (secrets and card data masked), the response and the time. Use the same address for partner keys, test hotels and early access.