2 APIs across 1 product group. All share one credential.
| I want to... | Use | Why |
|---|---|---|
| Set up or read hotels, codes, rate plans, daily rates, room types, and rooms | hetras Hotel API Version 0 | The Hotel API owns property-side configuration and does not touch guest reservations. |
| Check availability, create bookings, assign rooms, or run check-in and check-out | hetras Booking API Version 0 | The Booking API owns the reservation lifecycle and reads the rate plans the Hotel API configures. |
| Push updated daily rates from a revenue management system | hetras Hotel API Version 0 | Rate plan rate updates live on the Hotel API, including the batch rates endpoint. |
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the hetras APIs, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fhetras-certification.net" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fhetras-certification.net" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Once connected, ask your agent something like: .
What agents get from Jentic-routed access to this vendor.
Setup
Wiring both hetras APIs by hand means handling the partner credential the platform negotiates and writing retry logic across configuration reads and the reservation lifecycle. Through Jentic you install Jentic One once, add the hetras Hotel and Booking APIs from the Jentic directory, store the partner credential once, and your agent calls both.
Permission scoping
hetras puts the hotel, rate plan, and reservation identifiers in the URL path, so your own rules can pin an agent to one hotel or one booking. You choose which operations the agent may call, so writing rates or running check-in, check-out, and cancel is included only if you add it, while reading configuration and availability stays separate.
Credential isolation
Specific to using hetras APIs through Jentic.
What can an agent do across the hetras APIs?
An agent can read and update hotel-side configuration through the Hotel API, including hotels, codes, rate plans, daily rates, room types, and rooms, and it can run the full guest reservation lifecycle through the Booking API, including availability lookups, rate and addon retrieval, booking creation, room assignment, check-in, check-out, and cancellation.
How do the Hotel API and Booking API fit together?
The Hotel API defines the property setup that the Booking API operates against. You configure rate plans and room types on the Hotel API, then the Booking API reads that configuration to price stays, check availability, and create reservations. Keeping them separate lets you grant configuration access and reservation access independently.
Does one credential cover both hetras APIs?
Yes. Both APIs run on the same hetras cloud platform and use a single partner-issued credential negotiated with hetras. The certification specs themselves declare no security scheme, so production access is what requires that credential.
Which API should I start with?
Start with the Hotel API when you need to read or change property configuration such as rate plans, room types, and daily rates. Start with the Booking API when you need to check availability or take, modify, and cancel guest reservations. Many integrations use both.
BOOK A DEMO
Browse thousands of APIs and connect them all to your agent with Jentic One. One layer, one credential — every API your agent needs.
For Agents
An agent can read and update hotel configuration on hetras such as rate plans, daily rates, room types, and rooms, then check availability, create bookings, and run room assignment, check-in, check-out, and cancellation against those same properties.
hetras pairs a configuration API and a reservation API for chains running on its cloud hotel platform, so the same integration can own property setup and the full booking lifecycle. It targets a specific hetras-managed portfolio rather than acting as a cross-chain distribution aggregator.
Use for: Reading and updating hetras hotel configuration and running the guest booking lifecycle against properties on the hetras cloud platform
Not supported: cross-chain distribution, guest payment processing, channel manager hosting, OTA connectivity, published rate limits
Credentials: The certification specs define no security scheme; production access to both APIs requires a partner-issued credential negotiated with hetras, and that single partner credential covers both the Hotel and Booking surfaces.
All 2 hetras OpenAPI specs are third-party and indexed by Jentic, kept validated and agent-ready.
hetras is a cloud hotel management platform for hotel chains. Its APIs split cleanly into two surfaces: the Hotel API for property-side configuration such as hotels, codes, rate plans, daily rates, room types, and rooms, and the Booking API for the guest reservation lifecycle including availability lookups, rates, addons, booking creation, room assignment, check-in, check-out, and cancellation. Together they let integrations read and update hotel setup and take or modify reservations against hetras-managed properties.
Each workflow spans multiple hetras APIs. Jentic routes each operation to the right API automatically.
Configure a hotel then take bookings
An integration reads a hotel's rate plans and room types from the Hotel API to build its booking screen, then checks availability and creates reservations through the Booking API against the same property. The configuration read and the reservation write share one partner credential.
GET /api/hotel/v0/hotels/{hotelId}/rateplans to load the rate plans, then GET /api/booking/v0/availability and POST /api/booking/v0/bookings to create the reservation.
hetras Hotel API Version 0 + hetras Booking API Version 0
Channel manager sync across config and inventory
A channel manager discovers rate plans and room types from the Hotel API to map them to an OTA product taxonomy, then pulls availability and daily rates from the Booking API on a schedule and pushes confirmed reservations back. Both feeds run through the same hetras platform access.
GET /api/hotel/v0/hotels/{hotelId}/room_types to map products, then poll GET /api/booking/v0/availability and POST /api/booking/v0/bookings on OTA confirmations.
hetras Hotel API Version 0 + hetras Booking API Version 0
Revenue management price and occupancy loop
A revenue tool reads occupancy from the Booking API availability endpoint, computes new prices, and pushes them back to the Hotel API rate plan rates in a batch call so the next horizon reflects demand. hetras stays the system of record while the external model owns the math.
GET /api/booking/v0/availability for occupancy, then PUT /api/hotel/v0/hotels/{hotelId}/rateplans/batch/$rates with the new base prices.
hetras Booking API Version 0 + hetras Hotel API Version 0
Your hetras partner credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context, and the same stored credential serves both the Hotel and Booking APIs.
Intent-based discovery
An agent searches the Jentic directory by intent such as 'list hetras rate plans' or 'create a hotel booking', and Jentic returns the matching hetras operation with its input schema, so the agent picks the right endpoint across both APIs without reading the certification documentation.
Is hetras suited to cross-chain hotel distribution?
No. hetras targets a specific portfolio of properties running on its cloud platform rather than aggregating inventory across many chains. For global multi-chain discovery you would use a distribution aggregator, and for a single hetras-managed portfolio you would use these APIs directly.
Are these the production or certification endpoints?
The specs in the directory are the hetras certification versions. They describe the same API surface as production but do not publish rate limits or a security scheme, both of which are governed by your partner contract with hetras. Schedule heavy configuration or booking loads with the hetras team.
All 3 are in the Jentic catalogue with the same one-credential, intent-search pattern.