Developers
The public API of Galaxy Hotel Cloud: connect your booking engine, channel manager, POS or door-lock system to a property in a few steps.
Getting started
- 1
Send your request
Fill in the form at the bottom of the page with your company and the product you want to connect: we review the request and open the integrator portal for you.
- 2
Try it on the sandbox
In the portal you generate the product key of your product and the key of the test environment. GET /v1/me with the two keys answers with the property and the permissions; from there room types, rates, availability, reservations.
- 3
Go live
You fill in the product sheet (texts, logo, permissions requested) and send it for review. Once approved, the product enters the Marketplace of the hotels: each one activates it by accepting the permissions and you collect the key of the property from the portal or with the API, with no copy and paste. The sheet also appears in the Marketplace of the website.
What you can do
Availability and prices
Free rooms by type and night, rate plans and quotes computed by the rate engine of the PMS. For channel managers and booking engines, prices by number of guests, stop sale and minimum stay day by day, with an event when they change. For the showcase photos, logo, descriptions in several languages, services and size of the room types; in the quote the tourist tax, the cancellation policy, the board and the deposit the rate plan asks for.
Reservations
Create, change, confirm, cancel; assign rooms; check-in and check-out; guests in rooms with the data the authorities ask for. For channel managers, the bookings of the portals: never refused for a full type, also changed or cancelled, and what the PMS cannot handle by itself goes to the front desk.
Folios
Read the folios of a reservation and charge items: what a POS does when a guest signs the bill to the room.
Payments
Payment methods of the property, what a reservation was paid and the recording of a payment collected elsewhere, on the pre-account like a deposit; or a payment link of the hotel's card provider for the deposit, the balance or a guarantee; with a permission of its own, charges and refunds on the saved card.
Events and webhooks
Reservations created, check-ins, check-outs and cancellations in order, read with a cursor or pushed to your address by signed webhooks.
The first call
curl https://api.galaxy-hotel.net/v1/me \
-H "Authorization: Bearer gh_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "X-Product-Key: gh_prod_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
{
"key": { "name": "Booking engine", "scopes": ["availability:read", "reservations:write"] },
"product": { "id": 12, "name": "Booking engine", "company": "Acme Software", "status": "live" },
"property": { "id": 1, "code": "p1", "name": "Hotel Bella Vista" },
"account": { "name": "Bella Vista srl", "plan": "subscription" }
}
curl "https://api.galaxy-hotel.net/v1/availability?from=2026-11-01&to=2026-11-04" \
-H "Authorization: Bearer gh_live_…" -H "X-Product-Key: gh_prod_…"
curl -X POST https://api.galaxy-hotel.net/v1/reservations \
-H "Authorization: Bearer gh_live_…" -H "X-Product-Key: gh_prod_…" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: be-2026-000123" \
-d '{ "external_ref": "BE-2026-000123", "status": "confirmed",
"new_party": { "first_name": "Maria", "last_name": "Rossi", "email": "maria@example.com" },
"rooms": [{ "room_type_id": 2, "arrival": "2026-11-01", "departure": "2026-11-04", "adults": 2 }] }'The rules in short
- Two keys in every call: the property key in Authorization: Bearer (one per property, with the permissions the hotel accepted) and the product key of your product in X-Product-Key.
- JSON, dates YYYY-MM-DD with the departure excluded, decimal amounts in euro, errors with a stable code and a readable message.
- 600 calls a minute per key. Idempotency-Key on writes to repeat a call without double effects; external_ref unique per property on reservations.
- The version is in the path (/v1): fields are added, never removed or renamed.
MCP server for hotels
You do not need to become an integrator to connect an AI assistant: each person at the hotel creates their own key in the Marketplace inside the app (AI assistants (MCP)) or in My profile, and uses it with Claude, ChatGPT, Cursor, n8n or an agent of their own. The server speaks MCP over streamable HTTP: one JSON-RPC message per POST.
- The gh_mcp_… key goes in Authorization: Bearer. It belongs to one person and one property: the assistant sees only what that person sees in the PMS.
- The tools read the property, rooms, room types, rate plans, availability, reservations, guests and folios. Guests' documents, contact details and dates of birth never leave.
- With a «Read and proposals» key, check_in, check_out, assign_room and add_charge run nothing: they prepare a proposal that the person confirms or cancels in the app within 15 minutes.
- It is separate from the /v1 API: the keys of one do not work on the other, 120 calls a minute per key, and the sandbox has no MCP server.
claude mcp add --transport http galaxy https://api.galaxy-hotel.net/mcp \
--header "Authorization: Bearer gh_mcp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
curl -X POST https://api.galaxy-hotel.net/mcp \
-H "Authorization: Bearer gh_mcp_…" -H "Content-Type: application/json" \
-d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": { "name": "search_reservations", "arguments": { "status": "checked_in" } } }'Test environment
A shared environment with sample data, reset every night at 04:00 (Italian time). You create the test key from the integrator portal, one per product, with every permission: what you write is visible to the other integrators and disappears at the reset, together with the webhooks subscribed.
Need help?
Write to support@galaxy-hotel.net with the operation, the error code and the time of the call: calls are tracked per key.
Become an integrator
Using the API with hotels takes an approved product. Tell us who you are and what you want to connect: after approval you get access to the integrator portal, with the product key, the test environment and the guide.
Changelog
- November 2026 · MCP server for integrators (/integrator/mcp): each person of the integrator portal creates their own key (AI assistant (MCP)) and connects Claude Code, Cursor or Codex to the guide and reference of the API, their products with the checks before the review, the connected properties and the webhook deliveries; with «light actions» also the product sheet and the sandbox key.
- November 2026 · MCP server for hotels (/mcp): one key per person, reads and proposals confirmed in the app, to connect Claude, ChatGPT or another assistant to the data of a property.
- October 2026 · Integrators: request from the website, portal with product key and test key, product sheet in the Marketplace of the hotels, property keys to collect (GET /v1/connections); calls made for a product also carry the X-Product-Key header.
- September 2026 · First release: property, availability, quotes, reservations, guests, folios, events and webhooks.