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
Bearertoken orApiKeyheader- Format
- JSON responses,
successenvelope - Live
- 2 products · 17 endpoints
- Coming soon
- 5 products
# 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"# In-house guest list
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
-H "ApiKey: $HMS_API_KEY" \
-H "HotelCode: 1000"{
"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
}{
"success": 1,
"otelde": [
{
"unique": 58211,
"firstName": "AYŞE",
"lastName": "DEMİR",
"identityNumber": "11111111110",
"birthDate": "14.03.1985",
"roomName": "104",
"checkin": 1788863400,
"checkout": 1788998400,
"rezervasyon_id": 282799
}
]
}Products
Each product has its own documentation, API reference and code samples. Upcoming ones are announced in the changelog when they go live.
Online Booking
Booking engine API
Connects the hotel website’s booking engine to HMS: room and rate list, calendar availability, coupons, payment and booking push.
Hotspot
Guest Wi-Fi and 5651 logging
Feeds the in-house guest list to the hotspot system: room, identity, check-in and check-out times. For verifying guest Wi-Fi logins by room number and keeping Law 5651 access logs.
Restaurant POS
Checks and room charges
Posting restaurant, bar and café checks to the room folio, menu and stock synchronisation.
Spa
Appointments and services
Spa and wellness appointments, service catalogue and room-charge integration.
AI
Assistant and recommendation services
Access to AI services for the guest assistant, rate recommendations and reporting.
TV
In-room TV systems
Guest details, folio, messages and service requests for the in-room TV interface.
PBX
PBX and call records
PBX integration: enabling and disabling lines on check-in/out, posting call charges to the folio.
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.
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.
Working samples
cURL, Node.js and PHP samples are generated for every endpoint; copy them, add your key and run.
API referenceRecent changes
-
Hotspot API documentation publishedNewNew
-
Online Booking API documentation publishedNewNewNew
-
hmsdev.com launchedNew
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.