For Agents
Read accommodation availability and rates and create, modify, or cancel bookings against Newbook properties through OTA-style messages.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Newbook OTA API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | 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.
What an agent can do with Newbook OTA API API.
Test connectivity and credentials with the OTA Ping message
Retrieve descriptive hotel and instance information for connected properties
Get the room types and rate plan mapping for a property to drive a booking surface
Check live availability and rates for a property across given dates and occupancies
GET STARTED
Use for: Check availability and rates for a property next week, Create a booking at a Newbook property for two guests, Modify an existing reservation's check-out date, Cancel a Newbook booking by reservation reference
Not supported: Does not handle payments, guest communications, or housekeeping operations — use for OTA-style availability, rates, and reservation messages against Newbook properties only.
The Newbook OTA API exposes Newbook's property management system over Open Travel Alliance (OTA) message contracts, represented here as REST endpoints that wrap SOAP/XML payloads. Channel managers, OTAs, and direct booking surfaces use it to read availability and rates, push reservations, modify or cancel bookings, and manage availability and rate inventory (ARI) for accommodation properties. Authentication uses a WSSE header passed on every request.
Read existing booking details by reservation reference
Create, modify, or cancel bookings via the OTA HotelResNotif message
Configure ARI push settings to control how Newbook sends availability and rate updates
Patterns agents use Newbook OTA API API for, with concrete tasks.
★ OTA Channel Booking Push
Online travel agencies that take a reservation on their own surface forward the booking into Newbook by calling POST /OTA_HotelResNotifRQ with the OTA-formatted booking message. Newbook records the reservation against the property and the property staff see the new booking in their PMS without any manual entry.
POST to /OTA_HotelResNotifRQ with the OTA HotelResNotif message containing the guest, property, room type, rate plan, and arrival/departure dates; record Newbook's confirmation reference in the OTA's order record.
Real-Time Availability and Rate Lookup
Booking surfaces and metasearch integrations call POST /OTA_HotelAvailRQ to fetch live availability and pricing for a property and date range before quoting a guest. The response feeds the displayed rate so the guest only sees offers Newbook can actually fulfil.
POST to /OTA_HotelAvailRQ with the property code, arrival and departure dates, and occupancy; surface the cheapest available rate plan in the booking widget.
Reservation Modification and Cancellation
Guest service teams modify or cancel an existing booking by sending a HotelResNotif message with status 'Modify' or 'Cancel' through POST /OTA_HotelResNotifRQ. Newbook applies the change to the property's PMS calendar and inventory immediately, eliminating the dual-entry problem when handling changes from multiple channels.
POST to /OTA_HotelResNotifRQ with the existing reservation reference and a HotelResNotif message in 'Cancel' status to release the inventory back to availability.
AI Agent Concierge for Properties
A property concierge agent uses Jentic to discover Newbook OTA operations and answers guest questions like 'is a king room available next Friday?' by calling /OTA_HotelAvailRQ behind the scenes, then proceeds to /OTA_HotelResNotifRQ once the guest confirms — all through one credential bound at the agent level.
Use Jentic to search 'check hotel availability', load POST /OTA_HotelAvailRQ, execute it for the guest's dates, and on confirmation call POST /OTA_HotelResNotifRQ to create the booking.
7 endpoints — the newbook ota api exposes newbook's property management system over open travel alliance (ota) message contracts, represented here as rest endpoints that wrap soap/xml payloads.
METHOD
PATH
DESCRIPTION
/OTA_PingRQ
Connection test
/OTA_HotelDescriptiveInfoRQ
Retrieve hotel and instance information
/GetMappingRQ
Get room types and rate plans
/OTA_HotelAvailRQ
Check availability and rates
/OTA_ReadRQ
Retrieve booking details
/OTA_HotelResNotifRQ
Create, modify, or cancel bookings
/ARISettingsRQ
Configure ARI push settings
/OTA_PingRQ
Connection test
/OTA_HotelDescriptiveInfoRQ
Retrieve hotel and instance information
/GetMappingRQ
Get room types and rate plans
/OTA_HotelAvailRQ
Check availability and rates
/OTA_ReadRQ
Retrieve booking details
Three things that make agents converge on Jentic-routed access.
Credential isolation
Newbook WSSE credentials are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens — raw WSSE values never enter the agent's context.
Intent-based discovery
Agents search by intent (e.g., 'create a hotel booking') and Jentic returns matching Newbook OTA operations with their input schemas, so the agent can call the right endpoint without browsing OTA XSDs.
Time to first call
Direct Newbook OTA integration: 5-10 days because of OTA XML message shapes, WSSE auth, and certification with Newbook. Through Jentic: 1-2 hours — search, load schema, execute the OTA payload.
Alternatives and complements available in the Jentic catalogue.
Cloudbeds API
Property management system with REST API for hotel and short-term rental operations
Choose Cloudbeds when the property already runs on Cloudbeds; choose Newbook OTA when the target PMS is Newbook.
Beds24 API
Channel manager and PMS API covering availability, rates, and bookings
Choose Beds24 when an agent needs broad channel manager coverage; choose Newbook OTA when integrating directly with Newbook properties.
Booking.com API
Distribution channel that pushes reservations into the property's PMS
Pair Booking.com as the source of bookings with Newbook OTA as the PMS sink when an agent stitches OTA bookings into a Newbook-run property.
Specific to using Newbook OTA API API through Jentic.
What authentication does the Newbook OTA API use?
Newbook OTA uses a WSSE header passed on every request. Through Jentic, the WSSE credential is stored in the encrypted MAXsystem vault and injected at request time so it never appears in the agent's context.
Can I create bookings through the Newbook OTA API?
Yes. POST /OTA_HotelResNotifRQ accepts an OTA HotelResNotif message in 'Commit', 'Modify', or 'Cancel' status to create, change, or cancel a reservation in Newbook. The endpoint returns Newbook's confirmation reference for use in your own order record.
How do I check live availability and rates through Jentic?
Search Jentic for 'check hotel availability', load POST /OTA_HotelAvailRQ, and execute it with the property code, dates, and occupancy. The response contains the bookable rate plans and prices that Newbook will honour.
What are the rate limits for the Newbook OTA API?
Rate limits are not published numerically in the spec — Newbook scales API capacity by the property and channel partner agreement. Coordinate concurrency expectations with Newbook before running heavy availability polling against many properties.
Is the Newbook OTA API REST or SOAP?
The underlying contract is OTA SOAP/XML. Newbook represents each OTA message as a REST endpoint that accepts the corresponding XML body, so HTTP clients can call /OTA_HotelResNotifRQ etc. without a SOAP toolkit.
Is the Newbook OTA API free?
API access is included with Newbook's PMS subscription for connected properties or channel partners. There is no separate API tier — credentials are issued by Newbook as part of the partner onboarding process.
/OTA_HotelResNotifRQ
Create, modify, or cancel bookings
/ARISettingsRQ
Configure ARI push settings