Oracle Hospitality

Oracle Hospitality Availability API

The Availability APIs allow you to manage a properties room-rate availability, which is configured for a channel. This also includes operations to manage restrictions and hurdles.

GitHub OpenAPI

Operations 34

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /availability/summary Compare rate parity across hotels in a region · Gets the regional rate parity #
Ask an LLM
“Are my rates consistent across channels for all hotels in a chain or region?”
“Can I check rate parity for several hotels at once over the next few days?”
Tell an agent
Show the regional rate parity summary for hotels {hotelIds} over the next {numberOfDays} days.
Check multi-hotel parity for rate plan {ratePlanCode} on channel {channelCode} across chain {chainCode}.
GET /hotels/{hotelId}/channels/{channelCode}/rooms/{roomTypeCode}/inventorySnapshot Get channel inventory snapshot for one room type · Gets hotel room's restrictions and channel availability #
Ask an LLM
“What availability and restrictions does a booking channel see for one specific room type?”
“Can I snapshot a single room type's channel inventory for weekends only?”
Tell an agent
Snapshot channel {channelCode} inventory for room type {roomTypeCode} at hotel {hotelId} from {fromDate}.
Show restrictions and availability for room {roomTypeCode} on {channelCode} at {hotelId}, {fromDate} to {endDate}.
GET /hotels/{hotelId}/generalAvailabilitySimulator Simulate what a booking channel would see · Gets the General Availability #
Ask an LLM
“How can I preview the availability and rates a channel would return for a sample stay?”
“Can I simulate a booking request with a promotion code or corporate IATA to test channel results?”
Tell an agent
Run the availability simulator at hotel {hotelId} for arrival {arrival}, {nights} nights, {adults} adults.
Simulate channel {bookingChannelCode} results at {hotelId} with promotion {promotionCode}.
GET /hotels/{hotelId}/inventorySnapshot Get a hotel's channel inventory snapshot · Gets hotel's rooms and restrictions channel availability #
Ask an LLM
“What rooms and restrictions are all my booking channels seeing for a hotel right now?”
“Can I snapshot channel availability across several booking channels for a date range?”
Tell an agent
Snapshot channel inventory for all room types at hotel {hotelId} starting {fromDate}.
Show inventory for channels {bookingChannelCodes} at {hotelId} from {fromDate} to {endDate}.
GET /hotels/{hotelId}/rateParity Check a hotel's channel rate parity · Gets channel's rate configuration #
Ask an LLM
“Is my hotel's rate the same on every booking channel?”
“Can I compare channel rates for one room type and rate plan at a single property?”
Tell an agent
Check rate parity at hotel {hotelId} for the next {numberOfDays} days.
Compare parity for room {roomType} and rate plan {ratePlanCode} on channel {channelCode} at {hotelId}.
GET /availability Check availability across multiple hotels · Get Hotel Availability #
Ask an LLM
“Which of my hotels have rooms available for given dates and party size?”
“Can a central reservations office query availability for several hotels at once with query parameters?”
Tell an agent
Check availability at hotels {hotelIds} from {roomStayStartDate} to {roomStayEndDate} for {adults} adults.
Using CRO {cro}, list multi-hotel availability for rate plan {ratePlanCode} via query string.
POST /availability/searches Search multi-hotel availability with a POST body · Get Hotel Availability #
Ask an LLM
“Can I send multi-hotel availability criteria in a POST request body instead of a long query string?”
“What's the POST search for checking room availability across a CRO's hotels?”
Tell an agent
POST a multi-hotel availability search for hotels {hotelIds}, {roomStayStartDate} to {roomStayEndDate}.
Submit a body-based availability search across CRO {cro} hotels for membership level {membershipLevel}.
GET /hotels Search hotels for the sales process · Search hotels for the sales process #
Ask an LLM
“Which hotels in a city can I offer a guest for their dates?”
“Can I search hotels by amenity or nearby attraction during a sales call?”
Tell an agent
Find hotels in {city} with availability from {startDate} to {endDate}.
Search hotels in region {regionCode} offering amenity {hotelAmenity}.
GET /hotels/{hotelId}/analyzeRateAvailability Analyze why a rate is closed · Analyze Rate Availability #
Ask an LLM
“Why is a rate code showing closed for a room type on certain dates?”
“Can I see the restriction reasons behind an unavailable rate using query parameters?”
Tell an agent
Analyze why rate {ratePlanCode} is closed for room {roomType} at hotel {hotelId} from {startDate} to {endDate}.
Explain the closed-rate reasons for {ratePlanCode} at {hotelId} for {duration} nights.
POST /hotels/{hotelId}/analyzeRateAvailability/searches Analyze closed rates with a POST search body · Analyze Rate Availability #
Ask an LLM
“Can I submit the closed-rate analysis criteria as a POST body rather than query parameters?”
“Is there a POST search version of the rate availability analysis for a hotel?”
Tell an agent
POST a rate availability analysis for {ratePlanCode} at hotel {hotelId}, {startDate} to {endDate}.
Submit a body-based closed-rate analysis for block {blockId} at {hotelId}.
GET /hotels/{hotelId}/availability Get room and rate availability for one hotel · Get Hotel Availability #
Ask an LLM
“What room types and rates are available at a hotel for my dates?”
“Can I check a single property's availability including closed rates, via query parameters?”
Tell an agent
Show available rooms and rates at hotel {hotelId} from {roomStayStartDate} to {roomStayEndDate}.
Check availability at {hotelId} for {adults} adults and {children} children on rate plan {ratePlanCode}.
GET /hotels/{hotelId}/availability/alternate Find alternate dates for a closed rate · Get Alternate Availability #
Ask an LLM
“If a rate is closed on my dates, which nearby dates are open?”
“Can I look up alternate stay dates for a room type via query parameters?”
Tell an agent
Find alternate dates at hotel {hotelId} for rate {ratePlanCode} around {startDate}.
Suggest open dates for room {roomType} at {hotelId} for a {duration}-night stay.
POST /hotels/{hotelId}/availability/alternate/searches Search alternate dates with a POST body · Get Alternate Availability #
Ask an LLM
“Can I send alternate-date search criteria for a closed rate in a POST body?”
“Is there a POST search to find alternate dates for a block or a specific room id?”
Tell an agent
POST an alternate-date search at hotel {hotelId} for rate {ratePlanCode} starting {startDate}.
Submit a body-based alternate-date search for room {roomId} at {hotelId}.
POST /hotels/{hotelId}/availability/searches Search one hotel's availability with a POST body · Get Hotel Availability #
Ask an LLM
“Can I send single-hotel availability criteria in a POST request body?”
“What's the POST search for a property's rooms and rates when my criteria are too long for a URL?”
Tell an agent
POST an availability search for hotel {hotelId} from {roomStayStartDate} to {roomStayEndDate}.
Submit a body-based availability search at {hotelId} for membership {membershipType}.
GET /hotels/{hotelId}/availableUpsells Find available upsells for a stay · Get for Available Up-sells #
Ask an LLM
“Which room upgrades can I offer a guest on their reservation?”
“Can I list upsell options for a date range at a hotel?”
Tell an agent
Find upsell offers for reservation {reservationId} at hotel {hotelId}.
List available upsells at {hotelId} from {startDate} to {endDate} for room {roomType}.
GET /hotels/{hotelId}/guarantees Look up reservation guarantee options · Get Reservation Guarantee #
Ask an LLM
“Which guarantee types can I use for a booking arriving on a given date?”
“Can I see guarantee codes and estimated deposit amounts for a rate plan?”
Tell an agent
List guarantee options at hotel {hotelId} for arrival {arrivalDate}.
Get guarantees for rate {ratePlanCode} at {hotelId} arriving {arrivalDate}, with estimated amounts.
GET /hotels/{hotelId}/hurdles Get a hotel's hurdle rates · Get Hurdle Rates #
Ask an LLM
“What hurdle rates are set for my hotel on a given date?”
“Can I filter hurdle rates by room type code?”
Tell an agent
Show hurdle rates at hotel {hotelId} for {hurdleDate}.
List hurdle rates for room types {roomTypesCode} at {hotelId}.
POST /hotels/{hotelId}/hurdles Create new hurdle rates · Create Hurdle Rates #
Ask an LLM
“How do I set a new minimum acceptable rate (hurdle) for dates that have none?”
“What's needed to add hurdle rates for a hotel?”
Tell an agent
Create hurdle rates {hurdleRates} at hotel {hotelId}.
Add new hurdle rates for next month at {hotelId}.
PUT /hotels/{hotelId}/hurdles Change existing hurdle rates · Change Hurdle Rates #
Ask an LLM
“How do I raise an existing hurdle rate for peak dates?”
“Can I modify hurdle rates that are already set for a hotel?”
Tell an agent
Update the existing hurdle rates at hotel {hotelId}.
Change hurdle rates at {hotelId} to {hurdleRates}.
DELETE /hotels/{hotelId}/hurdles Delete hurdle rates · Delete Hurdle Rates #
Ask an LLM
“How do I remove a hurdle rate for a date?”
“Can I delete hurdle rates for one room type or yield category?”
Tell an agent destructive · confirm first
Delete hurdle rates at hotel {hotelId} for {hurdleDate}.
Remove hurdle rates for room {roomType} at {hotelId} from {hurdleRangeStart} to {hurdleRangeEnd}.
GET /hotels/{hotelId}/rates Get details for several rate plans at a hotel · Get the Rate Plan Information #
Ask an LLM
“Can I pull rate plan information for a list of rate codes in one call?”
“Where do I see the details of all the rate plans a hotel sells?”
Tell an agent
Get rate plan information at hotel {hotelId} for codes {ratePlanCodeList}.
Show the rate plans configured at {hotelId}.
GET /hotels/{hotelId}/rates/{ratePlanCode} Get information for one rate plan · Get Rate Plan Information #
Ask an LLM
“What are the details and rules of a specific rate plan code?”
“How do I look up one rate plan by its code at a hotel?”
Tell an agent
Show rate plan {ratePlanCode} at hotel {hotelId}.
Get the details of rate code {ratePlanCode} for {hotelId}.
GET /hotels/{hotelId}/restrictions Get restrictions for a date range · Get the Restrictions #
Ask an LLM
“What stay restrictions, like closed to arrival or minimum stay, are active at my hotel?”
“Can I see restrictions for one booking channel or rate plan over a date range?”
Tell an agent
List restrictions at hotel {hotelId} from {restrictionSearchCriteriaStartDate} to {end}.
Show restrictions for rate plan {ratePlanCode} on channel {bookingChannelCode} at {hotelId}.
POST /hotels/{hotelId}/restrictions Create a restriction · Create a Restriction #
Ask an LLM
“How do I close a rate to arrival or set a minimum length of stay?”
“What do I send to add a new restriction for a hotel?”
Tell an agent
Create restriction {restriction} at hotel {hotelId}.
Add a closed-to-arrival restriction at {hotelId} for this weekend.
PUT /hotels/{hotelId}/restrictions Clear all restrictions for a hotel on a date · Clear all Restrictions #
Ask an LLM
“How do I wipe every restriction at a hotel for one day?”
“Can I reset a date to have no restrictions at all?”
Tell an agent destructive · confirm first
Clear all restrictions at hotel {hotelId} on {date}.
Remove every restriction for {hotelId} on that date.
DELETE /hotels/{hotelId}/restrictions/{restrictionId} Delete a restriction · Delete a Restriction #
Ask an LLM
“How do I remove one restriction I set by mistake?”
“Can I delete a restriction only for certain dates or a room type?”
Tell an agent destructive · confirm first
Delete restriction {restrictionId} at hotel {hotelId}.
Remove restriction {restrictionId} at {hotelId} from {restrictionStartDate} to {restrictionEndDate}.
GET /hotels/{hotelId}/restrictionsHistory Get the change history of restrictions · Get the Restriction history #
Ask an LLM
“Who changed a restriction at my hotel, and when?”
“Can I audit restriction changes by user or restriction type over a period?”
Tell an agent
Show restriction history at hotel {hotelId} from {startDate} to {endDate}.
List restriction changes made by user {userId} at {hotelId}.
PUT /hotels/{hotelId}/validateGuarantees Validate guarantee criteria for a reservation · Get Reservation Guarantee #
Ask an LLM
“Can I validate a set of guarantee criteria against a hotel's rules before booking?”
“Is there a request-body version of the guarantee lookup for validating criteria?”
Tell an agent
Validate guarantee criteria {criteria} at hotel {hotelId}.
Check that this guarantee request is valid at {hotelId}.
GET /hurdles Get hurdle rates across multiple properties · Get multiple property Hurdle Rates #
Ask an LLM
“What are the hurdle rates for several of my hotels on the same date?”
“Can I compare hurdle rates across properties in one call?”
Tell an agent
Show hurdle rates for hotels {hotelIds} on {hurdleDate}.
Compare multi-property hurdle rates from {hurdleRangeStart} to {hurdleRangeEnd}.
GET /services/availability/status Get the availability service version · Get the Availability Service version #
Ask an LLM
“Which version of the availability service is running?”
“Is the availability service up and responding?”
Tell an agent
Report the availability service status and version.
Ping the availability service on behalf of hotel {hotelId}.
PUT /upsert/hotels/{hotelId}/hurdles Create or change hurdle rates · Create/Change Hurdle Rates #
Ask an LLM
“Is there an upsert for hurdle rates so I don't need to know if they already exist?”
“Can I create-or-update a batch of hurdle rates in one call?”
Tell an agent
Upsert hurdle rates {hurdleRates} at hotel {hotelId}.
Create or change hurdle rates at {hotelId}, whichever applies.
GET /hotels/{hotelId}/rates/coupons/{couponCode} Validate a coupon code · Validate a coupon code #
Ask an LLM
“Is a guest's coupon code valid at a hotel?”
“How do I check a coupon code on its own, without a promotion code?”
Tell an agent
Validate coupon {couponCode} at hotel {hotelId}.
Check whether coupon code {couponCode} works at {hotelId}.
GET /hotels/{hotelId}/rates/promotions/{promotionCode} Validate a promotion code · Validate a promotion code #
Ask an LLM
“Is a promotion code valid at my hotel?”
“How do I check a promo code on its own, without a coupon?”
Tell an agent
Validate promotion {promotionCode} at hotel {hotelId}.
Check whether promo code {promotionCode} is accepted at {hotelId}.
GET /hotels/{hotelId}/rates/promotionsCoupons Validate a promotion and coupon together · Validate promotion and coupon code #
Ask an LLM
“Does a coupon code work together with a specific promotion code?”
“Can I validate a promotion-and-coupon pair for a stay's dates?”
Tell an agent
Validate promotion {promotionCode} with coupon {couponCode} at hotel {hotelId}.
Check promo {promotionCode} plus coupon {couponCode} at {hotelId} from {startDate} to {endDate}.

Documentation

📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_oracle_hospitality_distribution_apis.htm
📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_oracle_hospitality_nor1_integrated_upsell_apis.htm
📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_property_apis.htm

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/openapi/oracle-hospitality-availability-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/oracle-hospitality:oracle-hospitality-availability-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

oracle-hospitality-availability-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Oracle Hospitality Availability API
  version: 26.2.0.0
  contact:
    email: hospitality_apis_ww_grp@oracle.com
  license:
    name: UPL
    url: https://opensource.org/licenses/upl
  termsOfService: https://www.oracle.com/legal/terms.html
  description: 'Operations tagged Availability across 3 of this provider''s published API definitions: oracle-hospitality-property-v1-chl.json, oracle-hospitality-property-v1-par.json, oracle-hospitality-property-v1-rtp.json. Each path carries the servers of the definition it was published in.'
servers:
- url: /chl/v1
- url: /par/v1
- url: /rtp/v1
tags:


# --- truncated at 32 KB (573 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/openapi/oracle-hospitality-availability-api-openapi.yml