Oracle Hospitality

Oracle Hospitality Rate Plan API

The Rate Plan APIs allow for creating, managing, and retrieving rates and their related components such as negotiated rates and packages.

GitHub OpenAPI
Business capability
Pricing & Rate Strategy Management BC-4030.20

Operations 112

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

POST /controlSegmentTemplate/{controlSegmentCode} Create a control segment template · Create Control Segment Template #
Ask an LLM
“How do I set up a new control segment template at the chain level?”
“Can I add a brand-new control segment template that properties can inherit?”
Tell an agent
Create a new control segment template with code {code}.
Add control segment template {code} to the template library.
DELETE /controlSegmentTemplate/{controlSegmentCode} Delete a control segment template · Delete Control Segment Template #
Ask an LLM
“Can I remove a control segment template that we no longer use?”
“What happens when I delete a control segment template from the chain setup?”
Tell an agent destructive · confirm first
Delete the control segment template {code}.
Remove template-level control segment {code} permanently.
PUT /controlSegmentTemplate/{controlSegmentCode} Modify a control segment template · Change Control Segment Template #
Ask an LLM
“Can I edit a chain-level control segment template after it has been created?”
“Is it possible to update several control segment templates in one call?”
Tell an agent
Update the control segment template {code} with the new template settings.
Change the rules on control segment template {code}.
GET /controlSegmentTemplates List control segment templates · Get Control Segment Templates #
Ask an LLM
“Which control segment templates are defined for our chain?”
“Can I filter control segment templates by membership type, including inactive ones?”
Tell an agent
List all control segment templates, including inactive ones.
Show control segment templates for membership type {type}.
GET /controlSegments Search property control segments · Get Control Segments #
Ask an LLM
“Which control segments are configured at a specific hotel?”
“Can I search property control segments by membership level?”
Tell an agent
Find the control segments configured at hotel {hotel}.
Search control segments at hotel {hotel} for membership type {type} and level {level}.
GET /hotels/{hotelId}/bestavailablerates Fetch best available rates for a hotel · Fetch Best Available Rates #
Ask an LLM
“What are the best available rates set up at my hotel starting next week?”
“Can I look up best available rates for a particular rate code and length of stay?”
Tell an agent
Show best available rates at hotel {hotelId} from {startDay}.
Get the best available rates for rate code {rateCode} at hotel {hotelId} between {startDay} and {endDay}.
POST /hotels/{hotelId}/bestavailablerates Create best available rates · Create a Best Available Rates #
Ask an LLM
“How do I load best available rates for a rate code into the property?”
“Can I define new BAR entries for several rate codes at once?”
Tell an agent
Create best available rates at hotel {hotelId} from the rates I provide.
Add these new BAR entries to hotel {hotelId}.
DELETE /hotels/{hotelId}/bestavailablerates Delete best available rates for a date range · Delete Best Available Rates #
Ask an LLM
“Can I clear best available rates for a rate code over a date range?”
“Is it possible to delete BAR only for weekends or certain lengths of stay?”
Tell an agent destructive · confirm first
Delete best available rates for rate code {code} at hotel {hotelId} from {start} to {end}.
Remove the Saturday best available rates for {code} at hotel {hotelId} between {start} and {end}.
GET /hotels/{hotelId}/blocks/ratePlans Find rate plans usable on a group block · Get rate plans for a given block #
Ask an LLM
“Which rate plans can I attach to a group block at my hotel?”
“Can I list only negotiated rate plans available to a company's block?”
Tell an agent
Show the rate plans available for blocks at hotel {hotelId} from {beginDate} to {endDate}.
List block rate plans at hotel {hotelId} negotiated for company {companyId}.
POST /hotels/{hotelId}/controlSegments/{controlSegmentCode} Create a hotel control segment · Create a new Control Segment #
Ask an LLM
“How do I add a control segment with rate rules to a single property?”
“Can a new property control segment be restricted to a membership type?”
Tell an agent
Create control segment {code} at hotel {hotelId} with the rules I give you.
Set up a membership-only control segment {code} at hotel {hotelId} for membership type {type}.
DELETE /hotels/{hotelId}/controlSegments/{controlSegmentCode} Delete a hotel control segment · Delete a Control Segment #
Ask an LLM
“Can I delete a control segment from one hotel without touching the template?”
“What does removing a property control segment do to its rules?”
Tell an agent destructive · confirm first
Delete control segment {code} at hotel {hotelId}.
Remove the property control segment {code} from hotel {hotelId}.
PUT /hotels/{hotelId}/controlSegments/{controlSegmentCode} Modify a hotel control segment · Modify a Control Segment #
Ask an LLM
“Can I change the rules on a control segment at one hotel?”
“Is it possible to switch a property control segment to require membership?”
Tell an agent
Update control segment {code} at hotel {hotelId} with new rules.
Deactivate control segment {code} at hotel {hotelId}.
DELETE /hotels/{hotelId}/massRateChangeLog Clear the mass rate change log · Delete mass rate change log #
Ask an LLM
“Can I wipe the mass rate change log for a hotel?”
“Is there a way to reset the log left behind by mass rate changes?”
Tell an agent destructive · confirm first
Delete the mass rate change log for hotel {hotelId}.
Clear out hotel {hotelId}'s mass rate change history log.
GET /hotels/{hotelId}/massRateChangeStatus Check the status of a mass rate change · Get mass rate change status #
Ask an LLM
“Has the mass rate change I started at my hotel finished?”
“Can I see detailed status for a running mass rate update?”
Tell an agent
Check the mass rate change status for hotel {hotelId}.
Show mass rate change progress at hotel {hotelId} with detail status {detail}.
PUT /hotels/{hotelId}/massRatePlanSchedules Update rate plan schedules in bulk · Set mass rate plan schedules #
Ask an LLM
“How do I change pricing schedules across many rate plans in one go?”
“Can I apply a mass update to rate plan schedules using criteria?”
Tell an agent
Run a mass rate plan schedule update at hotel {hotelId} using these criteria.
Apply the mass rate change criteria {criteria} to schedules at hotel {hotelId}.
GET /hotels/{hotelId}/negotiatedRates List a hotel's negotiated rates and profiles · Get negotiated rates and profiles #
Ask an LLM
“Which companies have negotiated rates at my hotel?”
“Can I include inactive negotiated rates when listing a property's corporate deals?”
Tell an agent
List every negotiated rate and its profile at hotel {hotelId}.
Show negotiated rates at hotel {hotelId} valid between {startDate} and {endDate}.
POST /hotels/{hotelId}/negotiatedRates Create a negotiated rate for a profile · Create negotiated rates #
Ask an LLM
“How do I give a corporate account a negotiated rate at my property?”
“Can I attach a new negotiated rate code to a travel agent profile?”
Tell an agent
Create a negotiated rate at hotel {hotelId} for the profile I specify.
Add these negotiated rates {rates} at hotel {hotelId}.
PUT /hotels/{hotelId}/negotiatedRates/distributions Distribute negotiated rates to other hotels · Distribute negotiated rates #
Ask an LLM
“Can I push a negotiated rate out to several other properties?”
“Which hotels can a negotiated rate be distributed to from this property?”
Tell an agent
Distribute negotiated rates from hotel {hotelId} to hotels {hotels}.
Share the negotiated rate list {rates} from hotel {hotelId} across our other properties.
PUT /hotels/{hotelId}/negotiatedRates/{rateCode} Change a negotiated rate for a profile · Change negotiated rates #
Ask an LLM
“Can I extend the dates on a company's existing negotiated rate?”
“How can I edit a negotiated rate code that's already linked to a profile?”
Tell an agent
Update negotiated rate {rateCode} at hotel {hotelId}.
Change the dates on negotiated rate {rateCode} at hotel {hotelId} for the profile I name.
GET /hotels/{hotelId}/negotiatedRates/{rateCode}/profiles List profiles holding a negotiated rate code · Fetch Negotiated Rates #
Ask an LLM
“Which profiles have been given a specific negotiated rate code at my hotel?”
“Who is entitled to a particular corporate rate code at this property?”
Tell an agent
Show the profiles linked to negotiated rate {rateCode} at hotel {hotelId}.
List accounts on rate code {rateCode} at hotel {hotelId}, include inactive set to {inactive}.
GET /hotels/{hotelId}/packageForecastGroups List a hotel's package forecast groups · Get Hotel Package Forecast Groups #
Ask an LLM
“Which package forecast groups exist at my property?”
“Can I search a hotel's package forecast groups by a partial code?”
Tell an agent
List the package forecast groups at hotel {hotelId}.
Find package forecast groups at hotel {hotelId} with code {code}.
POST /hotels/{hotelId}/packageForecastGroups Create package forecast groups at a hotel · Create Hotel Package Forecast Groups #
Ask an LLM
“How do I add a new package forecast group for one hotel?”
“Can I group packages for forecasting at a single property?”
Tell an agent
Create new package forecast groups at hotel {hotelId}.
Add package forecast group {groups} to hotel {hotelId}.
PUT /hotels/{hotelId}/packageForecastGroups Update a hotel's package forecast groups · Change Hotel Package Forecast Groups #
Ask an LLM
“Can I rename a package forecast group at one property?”
“Is it possible to edit existing hotel-level package forecast groups in bulk?”
Tell an agent
Update the package forecast groups at hotel {hotelId} with these changes.
Change hotel {hotelId}'s package forecast group descriptions.
DELETE /hotels/{hotelId}/packageForecastGroups Delete a hotel's package forecast groups · Delete Hotel Package Forecast Groups #
Ask an LLM
“Can I remove a package forecast group from one property?”
“What's the way to drop an unused hotel package forecast group?”
Tell an agent destructive · confirm first
Delete package forecast group {code} at hotel {hotelId}.
Remove the hotel-level forecast group {code} from hotel {hotelId}.
GET /hotels/{hotelId}/packageFormulaRanges Get package formula ranges · Get package formula ranges #
Ask an LLM
“What package formula ranges are defined at my hotel?”
“Can I filter package formula ranges by tax range type?”
Tell an agent
Show the package formula ranges at hotel {hotelId}.
List package formula ranges at hotel {hotelId} of tax range type {type}.
POST /hotels/{hotelId}/packageFormulaRanges Create package formula ranges · Create package formula ranges #
Ask an LLM
“How do I define new amount ranges for package formulas?”
“Can I add package formula ranges for a property?”
Tell an agent
Create package formula ranges at hotel {hotelId}.
Add these new formula ranges {ranges} to hotel {hotelId}.
PUT /hotels/{hotelId}/packageFormulaRanges/{packageFormulaRangeId} Change a package formula range · Change package formula ranges #
Ask an LLM
“Can I edit the amounts on a package formula range I already created?”
“Is there a way to modify a single package formula range by its ID?”
Tell an agent
Update package formula range {rangeId} at hotel {hotelId}.
Change the limits on formula range {rangeId} at hotel {hotelId}.
DELETE /hotels/{hotelId}/packageFormulaRanges/{packageFormulaRangeId} Delete a package formula range · Delete package formula ranges #
Ask an LLM
“Can I delete a package formula range I no longer need?”
“Does deleting a formula range let me target a specific amount and currency?”
Tell an agent destructive · confirm first
Delete package formula range {rangeId} at hotel {hotelId}.
Remove formula range {rangeId} at hotel {hotelId} for amount {amount} in {currency}.
GET /hotels/{hotelId}/packageGroups List package groups at a hotel · Get package groups #
Ask an LLM
“Which package groups are set up at my property?”
“Can I find package groups by a word in their description?”
Tell an agent
List the package bundles (package groups) defined at hotel {hotelId}.
Find package groups at hotel {hotelId} whose description contains {text}.
POST /hotels/{hotelId}/packageGroups Create a package group · Create package group #
Ask an LLM
“How do I bundle several packages into a new package group?”
“Can I create a package group like a breakfast-and-parking bundle?”
Tell an agent
Create a new package group at hotel {hotelId}.
Add package group {groups} to hotel {hotelId}.
PUT /hotels/{hotelId}/packageGroups Change a package group · Change package group #
Ask an LLM
“Can I change which packages belong to an existing package group?”
“How can I edit a package group's details at my hotel?”
Tell an agent
Edit the existing package bundles (package groups) at hotel {hotelId}.
Change the contents of existing package group {groups} at hotel {hotelId}.
DELETE /hotels/{hotelId}/packageGroups/{packageCode} Delete a package group · Delete package group #
Ask an LLM
“Can I delete a package group without deleting the packages inside it?”
“What's involved in removing a package group from a hotel?”
Tell an agent destructive · confirm first
Delete package group {code} at hotel {hotelId}.
Remove the package group with code {code} from hotel {hotelId}.
GET /hotels/{hotelId}/packages/{packageCode} Get one package's details · Get package for given package #
Ask an LLM
“What's included in a specific package code at my hotel?”
“Can I see the configuration of a single package, including its instructions?”
Tell an agent
Show the details of package {code} at hotel {hotelId}.
Get package {code} at hotel {hotelId} with instructions {fetch}.
POST /hotels/{hotelId}/packages/{packageCode} Create a package · Create package #
Ask an LLM
“How do I create a new package like breakfast included at my property?”
“Can I add a package code that can later be attached to rate plans?”
Tell an agent
Create package {code} at hotel {hotelId}.
Set up a new package with code {code} at hotel {hotelId}.
PUT /hotels/{hotelId}/packages/{packageCode} Update a package · Change the package #
Ask an LLM
“Can I change the price or posting of an existing package?”
“How do I edit a package that's already set up at my hotel?”
Tell an agent
Update package {code} at hotel {hotelId}.
Change the settings of existing package {code} at hotel {hotelId}.
DELETE /hotels/{hotelId}/packages/{packageCode} Delete a package · Delete the package #
Ask an LLM
“Can I delete a package code we've stopped selling?”
“Is removing a package from a hotel permanent?”
Tell an agent destructive · confirm first
Delete package {code} at hotel {hotelId}.
Remove package code {code} from hotel {hotelId} for good.
GET /hotels/{hotelId}/packages/{packageCode}/rates List rate plans that include a package · Get package rates #
Ask an LLM
“Which rate plans include a particular package?”
“What rate codes is a package attached to at my hotel?”
Tell an agent
List the rate plan codes that include package {code} at hotel {hotelId}.
Show which rates package {code} is attached to at hotel {hotelId}.
POST /hotels/{hotelId}/packages/{packageCode}/text Generate a package description with AI · Generate package description with AI Author Service Proxy #
Ask an LLM
“Can AI write a guest-facing description for one of my packages?”
“Could I give a prompt to shape an AI-generated package description?”
Tell an agent
Generate an AI description for package {code} at hotel {hotelId}.
Write a package description for {code} at hotel {hotelId} using the prompt {prompt}.
DELETE /hotels/{hotelId}/profiles/{profileId}/startDate/{startDate}/negotiatedRates/{ratePlanId} Remove a negotiated rate from a profile · Delete negotiated rates #
Ask an LLM
“Can I take a negotiated rate away from a company profile?”
“What do I need to delete a negotiated rate that starts on a given date?”
Tell an agent destructive · confirm first
Delete negotiated rate {ratePlanId} for profile {profileId} at hotel {hotelId} starting {startDate}.
Remove profile {profileId}'s negotiated rate {ratePlanId} at hotel {hotelId} effective {startDate}.
GET /hotels/{hotelId}/promotionCodes List a hotel's promotion codes · Get promotion codes #
Ask an LLM
“Which promotion codes are active at my hotel?”
“Can I find promotion codes tied to a certain rate code?”
Tell an agent
List the promotion codes at hotel {hotelId}.
Find property promotion codes at hotel {hotelId} in promotion group {group}.
PUT /hotels/{hotelId}/promotionCodes/{promotionCode} Change a hotel promotion code · Change promotion codes #
Ask an LLM
“Can I edit a promotion code that already exists at my property?”
“How do I update the rates a property promo code applies to?”
Tell an agent
Update promotion code {promo} at hotel {hotelId}.
Change the existing property promo {promo} at hotel {hotelId}.
POST /hotels/{hotelId}/promotionCodes/{promotionCode} Create a hotel promotion code · Create promotion codes #
Ask an LLM
“How do I create a new promo code guests can use at my hotel?”
“Can I add a promotion code to just one property?”
Tell an agent
Create promotion code {promo} at hotel {hotelId}.
Add a brand-new property promo {promo} to hotel {hotelId}.
POST /hotels/{hotelId}/promotionCodes/{promotionCode}/coupons Generate coupon codes for a hotel promotion · Generate promotion coupon codes #
Ask an LLM
“Can I generate a batch of unique coupon codes for a property promotion?”
“How do I produce single-use coupons under a hotel promo code?”
Tell an agent
Generate coupon codes for promotion {promo} at hotel {hotelId}.
Create a new batch of property coupons under promo {promo} at hotel {hotelId}.
GET /hotels/{hotelId}/promotionCodes/{promotionCode}/coupons List coupon codes for a hotel promotion · Get promotion coupon codes #
Ask an LLM
“What coupon codes have been generated under a promotion at my hotel?”
“Can I list a promotion's coupons from a certain batch?”
Tell an agent
List coupon codes for promotion {promo} at hotel {hotelId}.
Show coupons in batch {batch} for promotion {promo} at hotel {hotelId}.
PUT /hotels/{hotelId}/promotionCodes/{promotionCode}/coupons/{couponId} Update a coupon code for a hotel promotion · Update promotion coupon codes #
Ask an LLM
“Can I edit an individual coupon under a property promotion?”
“Is it possible to deactivate one hotel coupon code by its ID?”
Tell an agent
Update coupon {couponId} for promotion {promo} at hotel {hotelId}.
Change the details of property coupon {couponId} under promo {promo} at hotel {hotelId}.
GET /hotels/{hotelId}/promotionCodes/{promotionCode}/coupons/{couponId} Get one coupon code for a hotel promotion · Get promotion coupon code #
Ask an LLM
“Can I look up a single coupon by its ID under a hotel promotion?”
“What are the details of one specific property coupon code?”
Tell an agent
Show coupon {couponId} for promotion {promo} at hotel {hotelId}.
Look up property coupon {couponId} under promo {promo} at hotel {hotelId}.
GET /hotels/{hotelId}/promotionGroups List a hotel's promotion groups · Get promotion groups #
Ask an LLM
“Which promotion groups are set up at my property?”
“Can I search promotion groups by their description?”
Tell an agent
List the promotion groups at hotel {hotelId}.
Find promotion groups at hotel {hotelId} with code {code}.
PUT /hotels/{hotelId}/promotionGroups/copy Copy promotion groups to other hotels · Copy promotion groups #
Ask an LLM
“Can I copy promotion groups from one property to another?”
“Is there a quick way to replicate a hotel's promotion groups elsewhere?”
Tell an agent
Copy the promotion groups from hotel {hotelId} using these criteria.
Replicate promotion groups from hotel {hotelId} with copy criteria {criteria}.
PUT /hotels/{hotelId}/promotionGroups/{groupCode} Change a promotion group · Change promotion groups #
Ask an LLM
“Can I edit which promotions sit in an existing promotion group?”
“How do I rename a promotion group at my hotel?”
Tell an agent
Update promotion group {group} at hotel {hotelId}.
Change the description of promotion group {group} at hotel {hotelId}.
POST /hotels/{hotelId}/promotionGroups/{groupCode} Create a promotion group · Create promotion groups #
Ask an LLM
“How do I create a group to organize related promotion codes?”
“Can I add a new promotion group to a property?”
Tell an agent
Create promotion group {group} at hotel {hotelId}.
Set up a new promotion group called {group} at hotel {hotelId}.
DELETE /hotels/{hotelId}/promotionGroups/{groupCode} Delete a promotion group · Delete promotion groups #
Ask an LLM
“Can I delete a promotion group we no longer use?”
“What happens to a promotion group once I remove it from a hotel?”
Tell an agent destructive · confirm first
Delete promotion group {group} at hotel {hotelId}.
Remove the promotion group {group} from hotel {hotelId}.
PUT /hotels/{hotelId}/rateAccessExclusions Set rate access exclusions · Set rate access exclusions #
Ask an LLM
“Can I block a booking channel from creating reservations on a rate code?”
“How do I stop a source from seeing a rate in availability?”
Tell an agent
Set rate access exclusions at hotel {hotelId}.
Apply these rate access exclusions {exclusions} at hotel {hotelId}.
DELETE /hotels/{hotelId}/rateAccessExclusions Delete rate access exclusions · Delete rate access exclusions #
Ask an LLM
“Can I lift a rate access exclusion so a source can book the rate again?”
“Is it possible to delete exclusions for one rate code over a date range?”
Tell an agent destructive · confirm first
Delete rate access exclusions for rate code {rateCode} at hotel {hotelId}.
Remove access exclusions on rate {rateCode} at hotel {hotelId} from {start} to {end}.
GET /hotels/{hotelId}/rateGroups List rate groups at a hotel · Get rate groups #
Ask an LLM
“Which rate groups are configured at my hotel?”
“Can I search rate groups by a partial code or description?”
Tell an agent
List the rate groups at hotel {hotelId}.
Find rate groups at hotel {hotelId} with code {code}.
PUT /hotels/{hotelId}/rateGroups Change existing rate groups · Change rate groups #
Ask an LLM
“Can I rename an existing rate group at my property?”
“How do I edit rate groups that are already configured?”
Tell an agent
Update the existing rate groups at hotel {hotelId}.
Change rate group details {groups} at hotel {hotelId}.
POST /hotels/{hotelId}/rateGroups Create rate groups · Create rate groups #
Ask an LLM
“How do I create a rate group to organize rate plans?”
“Can I add several new rate groups to a hotel at once?”
Tell an agent
Create new rate groups at hotel {hotelId}.
Add rate groups {groups} to hotel {hotelId}.
DELETE /hotels/{hotelId}/rateGroups Delete rate groups · Delete rate groups #
Ask an LLM
“Can I delete the rate groups configured at a property?”
“What does removing rate groups from a hotel involve?”
Tell an agent destructive · confirm first
Delete the rate groups at hotel {hotelId}.
Remove rate groups from hotel {hotelId}.
GET /hotels/{hotelId}/ratePlan/schedule/yieldAdjustment Get yield adjustments on rate plan schedules · Get rate plan schedule yield adjustments #
Ask an LLM
“Which rate plan schedules carry yield adjustments at my hotel?”
“Can I see yield adjustments for a single rate plan's schedules?”
Tell an agent
Show rate plan schedule yield adjustments at hotel {hotelId}.
Get schedule yield adjustments for rate plan {code} at hotel {hotelId}.
POST /hotels/{hotelId}/ratePlanSchedules/{scheduleId}/split Split a rate plan schedule · Split rate plan schedule #
Ask an LLM
“Can I split one pricing schedule into two date ranges?”
“How do I break a rate plan schedule so part of it gets a different price?”
Tell an agent
Split rate plan schedule {scheduleId} at hotel {hotelId}.
Split schedule {scheduleId} at hotel {hotelId} using split details {details}.
GET /hotels/{hotelId}/ratePlans Get rate plans for a hotel · Get rate plans by Hotel Code #
Ask an LLM
“What rate plans does a given hotel have?”
“Can I get a hotel's rate plans for a posting interval other than nightly?”
Tell an agent
List the rate plans configured under hotel code {hotelId}.
Get hotel {hotelId}'s rate plans with posting interval {interval}.
POST /hotels/{hotelId}/ratePlans Create a rate plan · Create rate plans #
Ask an LLM
“How do I create a new rate plan for my hotel?”
“Can I add a rate code with its room types and controls in one request?”
Tell an agent
Create a new rate plan at hotel {hotelId}.
Add rate plan {ratePlan} to hotel {hotelId}.
PUT /hotels/{hotelId}/ratePlans/sync Sync rate plans across properties · Synchronizes Rate Plan information including Rate Header and Packages across… #
Ask an LLM
“Can I make a rate code identical across all our hotels that share it?”
“How do I push a rate header and its packages to other properties?”
Tell an agent
Sync rate codes {codes} from hotel {hotelId} to target properties {target}.
Synchronize rate plan {codes} from hotel {hotelId} to {target}.
GET /hotels/{hotelId}/ratePlans/{ratePlanCode} Get one rate plan · Get rate plan #
Ask an LLM
“What are the details of a specific rate plan code at my hotel?”
“Can I retrieve a single rate plan with its instructions?”
Tell an agent
Show rate plan {code} at hotel {hotelId}.
Get the full details of rate code {code} at hotel {hotelId}.
PUT /hotels/{hotelId}/ratePlans/{ratePlanCode} Change a rate plan · Change rate plan #
Ask an LLM
“Can I change the date range of an existing rate plan?”
“How do I update the room types linked to a rate code?”
Tell an agent
Update rate plan {code} at hotel {hotelId}.
Change the rate controls on rate plan {code} at hotel {hotelId}.
DELETE /hotels/{hotelId}/ratePlans/{ratePlanCode} Delete a rate plan · Delete rate plan #
Ask an LLM
“Can I delete a rate plan that's no longer sold?”
“Is deleting a rate code from a hotel reversible?”
Tell an agent destructive · confirm first
Delete rate plan {code} at hotel {hotelId}.
Remove rate code {code} from hotel {hotelId}.
PUT /hotels/{hotelId}/ratePlans/{ratePlanCode}/copy Copy a rate plan · Copy rate plans #
Ask an LLM
“Can I clone an existing rate plan into a new rate code?”
“What's the fastest way to duplicate a rate plan?”
Tell an agent
Copy rate plan {code} at hotel {hotelId}.
Duplicate rate plan {code} at hotel {hotelId} using copy criteria {criteria}.
PUT /hotels/{hotelId}/ratePlans/{ratePlanCode}/dailySchedules Set a daily rate schedule range · Set daily rate plan schedule range #
Ask an LLM
“How do I set day-by-day prices on a rate plan for a date range?”
“Can I load daily rate amounts for a rate code?”
Tell an agent
Set the daily schedule range for rate plan {code} at hotel {hotelId}.
Apply daily rates {range} to rate plan {code} at hotel {hotelId}.
DELETE /hotels/{hotelId}/ratePlans/{ratePlanCode}/dailySchedules Delete daily rate schedules for a range · Delete daily rate plan schedule range #
Ask an LLM
“Can I clear the daily rates on a rate plan for certain dates?”
“Is it possible to delete daily rate schedules only for one room type?”
Tell an agent destructive · confirm first
Delete daily schedules for rate plan {code} at hotel {hotelId} from {startDate} to {endDate}.
Clear daily rates on {code} at hotel {hotelId} for room type {roomType} between {startDate} and {endDate}.
GET /hotels/{hotelId}/ratePlans/{ratePlanCode}/metrics Get dependency counts for a rate plan · Get rate plan metrics #
Ask an LLM
“How many rates are derived from this base rate plan?”
“Can I count the pricing schedules on a rate plan before deleting it?”
Tell an agent
Show the metrics for rate plan {code} at hotel {hotelId}.
Count dependent base rates and schedules for rate plan {code} at hotel {hotelId}.
PUT /hotels/{hotelId}/ratePlans/{ratePlanCode}/packages Change packages on a rate plan · Change rate plan package #
Ask an LLM
“Can I change the package already included in a rate plan?”
“How do I edit the package attached to a rate code?”
Tell an agent
Update the packages on rate plan {code} at hotel {hotelId}.
Change existing packages {packages} on rate plan {code} at hotel {hotelId}.
POST /hotels/{hotelId}/ratePlans/{ratePlanCode}/packages Add a package to a rate plan · Create rate plan package #
Ask an LLM
“How do I include breakfast in a rate plan?”
“Can I attach a new package to an existing rate code?”
Tell an agent
Attach packages {packages} to rate plan {code} at hotel {hotelId}.
Add a new package to rate plan {code} at hotel {hotelId}.
DELETE /hotels/{hotelId}/ratePlans/{ratePlanCode}/packages Remove packages from a rate plan · Delete rate plan packages #
Ask an LLM
“Can I remove a package from a rate plan without deleting the package itself?”
“Is there a way to detach a whole package group from a rate code?”
Tell an agent destructive · confirm first
Remove package {pkg} from rate plan {code} at hotel {hotelId}.
Detach package group {group} from rate plan {code} at hotel {hotelId}.
PUT /hotels/{hotelId}/ratePlans/{ratePlanCode}/postingRhythms Change posting rhythms on a rate plan · Change rate plan posting rhythms #
Ask an LLM
“Can I change how often a rate plan posts charges to the folio?”
“How do I edit a rate code's existing posting rhythm?”
Tell an agent
Update the posting rhythms on rate plan {code} at hotel {hotelId}.
Change existing posting rhythms {rhythms} on rate plan {code} at hotel {hotelId}.
POST /hotels/{hotelId}/ratePlans/{ratePlanCode}/postingRhythms Add posting rhythms to a rate plan · Create rate plan posting rhythms #
Ask an LLM
“How do I set a rate plan to post weekly instead of nightly?”
“Can I add a new posting rhythm to a rate code?”
Tell an agent
Add posting rhythms {rhythms} to rate plan {code} at hotel {hotelId}.
Create a posting rhythm for rate plan {code} at hotel {hotelId}.
DELETE /hotels/{hotelId}/ratePlans/{ratePlanCode}/postingRhythms Delete posting rhythms from a rate plan · Delete rate plan posting rhythms #
Ask an LLM
“Can I remove a posting rhythm from a rate plan?”
“What's needed to delete one posting rhythm code off a rate?”
Tell an agent destructive · confirm first
Delete posting rhythm {rhythm} from rate plan {code} at hotel {hotelId}.
Remove the posting rhythms on rate plan {code} at hotel {hotelId}.
GET /hotels/{hotelId}/ratePlans/{ratePlanCode}/schedules Get a rate plan's pricing schedules · Get rate plan schedules #
Ask an LLM
“What prices are scheduled on a rate plan for next month?”
“Can I see a rate plan's schedules for just one room type?”
Tell an agent
Show the pricing schedules for rate plan {code} at hotel {hotelId}.
Get schedules for rate plan {code} at hotel {hotelId} from {startDate} to {endDate} for room type {roomType}.
PUT /hotels/{hotelId}/ratePlans/{ratePlanCode}/schedules Change a rate plan's pricing schedules · Change rate plan schedules #
Ask an LLM
“Can I change the amounts on existing pricing schedules of a rate plan?”
“How do I edit a rate plan schedule that's already loaded?”
Tell an agent
Update the existing schedules on rate plan {code} at hotel {hotelId}.
Change schedule list {schedules} on rate plan {code} at hotel {hotelId}.
POST /hotels/{hotelId}/ratePlans/{ratePlanCode}/schedules Create pricing schedules for a rate plan · Create rate plan schedules #
Ask an LLM
“How do I add a new season's prices to a rate plan?”
“Can I create additional pricing schedules on a rate code?”
Tell an agent
Create pricing schedules for rate plan {code} at hotel {hotelId}.
Add new schedules {schedules} to rate plan {code} at hotel {hotelId}.
DELETE /hotels/{hotelId}/ratePlans/{ratePlanCode}/schedules Delete pricing schedules from a rate plan · Delete rate plan schedule #
Ask an LLM
“Can I delete specific pricing schedules from a rate plan by ID?”
“Is it possible to remove a rate plan's schedules for one season only?”
Tell an agent destructive · confirm first
Delete schedules {ids} from rate plan {code} at hotel {hotelId}.
Remove schedules {ids} in season {season} from rate plan {code} at hotel {hotelId}.
PUT /hotels/{hotelId}/ratePlans/{ratePlanCode}/schedules/set Set a rate plan's schedules · Set rate plan schedules #
Ask an LLM
“Can I set a rate plan's schedules in one call, replacing what's there?”
“Which call sets a single rate code's schedule list directly?”
Tell an agent
Set the schedules for rate plan {code} at hotel {hotelId} to {schedules}.
Overwrite rate plan {code}'s schedule set at hotel {hotelId}.
PUT /hotels/{hotelId}/ratePlans/{ratePlanCode}/sourceTiers/{sourceTierId}/destinationTiers/{destinationTierId}/schedules/copy Copy schedules between rate tiers · Copy tiered rate schedules #
Ask an LLM
“Can I copy pricing from one rate tier to another on the same rate plan?”
“Is it possible to add an adult or child offset when copying tiered schedules?”
Tell an agent
Copy schedules on rate plan {code} at hotel {hotelId} from tier {source} to tier {dest}.
Copy tier {source} schedules to tier {dest} on {code} at hotel {hotelId} with adult offset {offset}.
GET /hotels/{hotelId}/rateStrategies List a hotel's rate strategies · Get rate strategies #
Ask an LLM
“What rate strategies are in place at my hotel?”
“Can I see which rate strategies restrict a particular date?”
Tell an agent
List the rate strategies at hotel {hotelId}.
Show rate strategies at hotel {hotelId} restricting {date}.
POST /hotels/{hotelId}/rateStrategies Create a rate strategy at a hotel · Create rate strategies #
Ask an LLM
“How do I create a rate strategy that closes rates when occupancy is high?”
“Can I add a new rate strategy to one property?”
Tell an agent
Create a rate strategy at hotel {hotelId}.
Add rate strategy {strategy} to hotel {hotelId}.
PUT /hotels/{hotelId}/rateStrategies/{rateStrategyId} Change a rate strategy · Change rate strategies #
Ask an LLM
“Can I edit an existing rate strategy by its ID?”
“How do I adjust the thresholds on a rate strategy I already set up?”
Tell an agent
Update rate strategy {strategyId} at hotel {hotelId}.
Change the settings of rate strategy {strategyId} at hotel {hotelId}.
DELETE /hotels/{hotelId}/rateStrategies/{rateStrategyId} Delete a rate strategy · Delete rate strategies #
Ask an LLM
“Can I delete a rate strategy that's no longer needed?”
“What happens when a rate strategy is removed from a hotel?”
Tell an agent destructive · confirm first
Delete rate strategy {strategyId} at hotel {hotelId}.
Remove rate strategy {strategyId} from hotel {hotelId}.
GET /hotels/{hotelId}/rates/activityLog View the rate activity log · Get rate activity log #
Ask an LLM
“Who changed a rate plan and when?”
“Can I search the rate activity log by user or date range?”
Tell an agent
Show rate activity at hotel {hotelId} for module {module} where {name} is {value}.
Get the rate activity log at hotel {hotelId} for module {module}, {name} {value}, from {fromDate} to {toDate}.
GET /hotels/{hotelId}/yieldAdjustments Get a hotel's yield adjustments · Get yield adjustments #
Ask an LLM
“What yield adjustments are configured at my hotel?”
“Can I view yield adjustments in a particular currency?”
Tell an agent
List the yield adjustments at hotel {hotelId}.
Show yield adjustments at hotel {hotelId} in currency {currency}.
GET /packageForecastGroups List template package forecast groups · Get Template Package Forecast Groups #
Ask an LLM
“Which package forecast groups exist at the chain template level?”
“Can I search template forecast groups by a wildcard code?”
Tell an agent
List the template package forecast groups, with inactive ones set to {inactive}.
Find template package forecast group {code}, include inactive {inactive}.
POST /packageForecastGroups Create template package forecast groups · Create Template Package Forecast Groups #
Ask an LLM
“How do I add a package forecast group to the chain template?”
“Can new template forecast groups be created for properties to inherit?”
Tell an agent
Create new template package forecast groups.
Add template forecast groups {groups} at the chain level.
PUT /packageForecastGroups Update template package forecast groups · Change Template Package Forecast Groups #
Ask an LLM
“Can I edit a chain-level package forecast group template?”
“How do I change template forecast groups shared by all properties?”
Tell an agent
Update the template package forecast groups with these changes.
Change template forecast groups {groups}.
DELETE /packageForecastGroups/{packageForecastGroupCode} Delete a template package forecast group · Delete Template Package Forecast Groups #
Ask an LLM
“Can I delete a package forecast group from the chain template?”
“What's the way to retire a template-level forecast group?”
Tell an agent destructive · confirm first
Delete template package forecast group {code}.
Remove forecast group {code} from the chain template.
GET /packages Search packages · Get packages #
Ask an LLM
“Which packages can be sold at a hotel for given dates and guest counts?”
“Can I search packages by category or a word in the description?”
Tell an agent
Search packages at hotel {hotelId}.
Find packages at hotel {hotelId} in category {category} from {startDate} to {endDate}.
PUT /packages/copy Copy package codes between hotels · Copy package code(s) #
Ask an LLM
“Can I copy package codes from one hotel to another?”
“Is there a way to replicate a property's packages at a sister hotel?”
Tell an agent
Copy package codes from hotel {hotel} to another property.
Replicate our package codes to the sister property.
PUT /packages/text/{responseId} Save an AI-generated package description · Save the package description to the AI Author Service #
Ask an LLM
“How do I keep the package description the AI author produced?”
“Can I save edited text back to the AI Author Service for a package?”
Tell an agent
Save the text {text} for AI author response {responseId}.
Store the generated package description from response {responseId}.
GET /profiles/{profileId}/negotiatedRates Get a profile's negotiated rates · Get negotiated rate details for given profile #
Ask an LLM
“What negotiated rates does a company profile have across our hotels?”
“Can I see one guest profile's negotiated rates at a specific hotel?”
Tell an agent
Show the negotiated rates for profile {profileId}.
List negotiated rates for profile {profileId} at hotel {hotelCode}.
GET /promotionCodes List template promotion codes · Get Template Promotion Codes #
Ask an LLM
“Which promotion codes exist in the chain template?”
“Can I search template promotion codes by promotion group?”
Tell an agent
List the template promotion codes.
Find template promotion codes in group {group}.
PUT /promotionCodes/{promotionCode} Change a template promotion code · Change Template Promotion Code #
Ask an LLM
“Can I edit a chain-level promotion code template?”
“How do I update an existing template promo code?”
Tell an agent
Update template promotion code {promo}.
Change the chain template promo {promo}.
POST /promotionCodes/{promotionCode} Create a template promotion code · Create Template Promotion Code #
Ask an LLM
“How do I create a promo code at the chain template level?”
“Can I add a template promotion code properties can adopt?”
Tell an agent
Create template promotion code {promo}.
Add a new chain template promo {promo}.
POST /promotionCodes/{promotionCode}/coupons Generate coupon codes for a template promotion · Generate template promotion coupon codes #
Ask an LLM
“Can I generate coupons at the chain template promotion level?”
“How are coupon codes produced for a template promo?”
Tell an agent
Generate coupon codes for template promotion {promo}.
Create a batch of template-level coupons for promo {promo}.
GET /promotionCodes/{promotionCode}/coupons List coupon codes for a template promotion · Get promotion coupon codes at template level #
Ask an LLM
“Which coupons have been generated under a chain template promotion?”
“Can I list template promotion coupons created on a certain date?”
Tell an agent
List coupon codes for template promotion {promo}.
Show template coupons in batch {batch} for promotion {promo}.
PUT /promotionCodes/{promotionCode}/coupons/inactivate Deactivate a batch of promotion coupons · Inactivate promotion coupon codes for a given batch code #
Ask an LLM
“Can I switch off every coupon in one batch at once?”
“Is there a way to invalidate a leaked batch of promotion coupons?”
Tell an agent destructive · confirm first
Inactivate coupon batch {batch} for promotion {promo}.
Deactivate all coupons in batch {batch} for promotion {promo} at hotel {hotel}.
PUT /promotionCodes/{promotionCode}/coupons/{couponId} Update one coupon for a template promotion · Update promotion coupon codeat template level #
Ask an LLM
“Can I edit a single coupon under a template promotion?”
“How do I change one template-level coupon code's details?”
Tell an agent
Update template coupon {couponId} for promotion {promo}.
Change chain template coupon {couponId} under promo {promo}.
GET /promotionCodes/{promotionCode}/coupons/{couponId} Get one coupon for a template promotion · Get promotion coupon code at template level #
Ask an LLM
“Can I look up a single template-level coupon by its ID?”
“What are the details of one coupon under a chain template promo?”
Tell an agent
Show template coupon {couponId} for promotion {promo}.
Look up coupon {couponId} under chain template promo {promo}.
PUT /ratePlanSchedules Manage schedules across hotels' rate plans · Manages rate plan schedules #
Ask an LLM
“Can I update rate plan schedules for several hotels in one request?”
“Is there a multi-property way to manage rate schedules?”
Tell an agent
Update rate plan schedules across hotels with {schedules}.
Manage schedules for multiple hotels' rate plans in one batch.
GET /ratePlans Search rate plans · Get rate plans #
Ask an LLM
“Which rate plans are sellable on a given date at a hotel?”
“Can I search rate plans by category or only day-use rates?”
Tell an agent
Search rate plans for hotel {hotelId}.
Find rate plans at hotel {hotelId} in category {category} sellable on {sellDate}.
POST /rateStrategies Set rate strategies across hotels · Set rate strategies #
Ask an LLM
“Can I set rate strategies for many properties in one request?”
“Is there a bulk call for applying rate strategies without a hotel in the path?”
Tell an agent
Set these rate strategies {strategies}.
Apply rate strategies in bulk across our properties.
GET /services/rateplan/status Check the rate plan service version · Get Rate plan service version #
Ask an LLM
“Is the rate plan service up and responding?”
“What version of the rate plan service is running?”
Tell an agent
Check the rate plan service status for hotel {hotel}.
Get the rate plan service version.
PUT /upsert/hotels/{hotelId}/packageFormulaRanges Create or update package formula ranges · Create/Change package formula ranges #
Ask an LLM
“Can I upsert package formula ranges without checking if they exist?”
“Is there one call that creates or changes formula ranges?”
Tell an agent
Upsert package formula ranges at hotel {hotelId}.
Create or update formula ranges {ranges} at hotel {hotelId}.
PUT /upsert/hotels/{hotelId}/promotionCodes/{promotionCode} Create or update a hotel promotion code · Change/Create promotion codes #
Ask an LLM
“Can I upsert a property promotion code in one call?”
“Is there a way to create a promo code if missing or update it if present?”
Tell an agent
Upsert promotion code {promo} at hotel {hotelId}.
Create or update property promo {promo} at hotel {hotelId}.
PUT /upsert/hotels/{hotelId}/rateGroups Create or update rate groups · Change/Create rate groups #
Ask an LLM
“Can I upsert rate groups instead of creating and updating separately?”
“Is there a single call to create or change rate groups?”
Tell an agent
Upsert rate groups at hotel {hotelId}.
Create or update rate groups {groups} at hotel {hotelId}.
PUT /upsert/hotels/{hotelId}/rateStrategies Create or update a rate strategy · Create/Change rate strategies #
Ask an LLM
“Can I upsert a rate strategy at a property?”
“Is there one call to create a rate strategy or update it if it exists?”
Tell an agent
Upsert a rate strategy at hotel {hotelId}.
Create or update rate strategy {strategy} at hotel {hotelId}.
PUT /upsert/promotionCodes/{promotionCode} Create or update a template promotion code · Change/create Template Promotion Code #
Ask an LLM
“Can I upsert a chain template promotion code?”
“Is there a single call to create or change a template promo code?”
Tell an agent
Upsert template promotion code {promo}.
Create or update chain template promo {promo}.

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-rate-plan-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-rate-plan-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-rate-plan-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: OPERA Cloud Rate Rate Plan API
  description: APIs to cater for Rate Availability functionality in OPERA Cloud.
  version: 26.2.0.0
  termsOfService: https://www.oracle.com/legal/terms.html
  contact:
    email: hospitality_apis_ww_grp@oracle.com
  license:
    name: UPL
    url: https://opensource.org/licenses/upl
servers:
- url: /rtp/v1
tags:


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