# Oracle Hospitality Rate Plan API

**Canonical:** https://apis.io/apis/oracle-hospitality/oracle-hospitality-rate-plan-api/  
**Provider:** Oracle Hospitality — https://apis.io/providers/oracle-hospitality/  
**Base URL:** /rtp/v1  
**Documentation:** https://github.com/oracle/hospitality-api-docs/blob/main/graphql/data-apis/Activities.graphql

Oracle Hospitality Rate Plan API is one of 153 APIs that [Oracle Hospitality](https://apis.io/providers/oracle-hospitality/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Rate Plan. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

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

## Operations (60 of 112)

| Method | Path | Summary |
|---|---|---|
| POST | `/controlSegmentTemplate/{controlSegmentCode}` | Create Control Segment Template |
| DELETE | `/controlSegmentTemplate/{controlSegmentCode}` | Delete Control Segment Template |
| PUT | `/controlSegmentTemplate/{controlSegmentCode}` | Change Control Segment Template |
| GET | `/controlSegmentTemplates` | Get Control Segment Templates |
| GET | `/controlSegments` | Get Control Segments |
| GET | `/hotels/{hotelId}/bestavailablerates` | Fetch Best Available Rates |
| POST | `/hotels/{hotelId}/bestavailablerates` | Create a Best Available Rates |
| DELETE | `/hotels/{hotelId}/bestavailablerates` | Delete Best Available Rates |
| GET | `/hotels/{hotelId}/blocks/ratePlans` | Get rate plans for a given block |
| POST | `/hotels/{hotelId}/controlSegments/{controlSegmentCode}` | Create a new Control Segment |
| DELETE | `/hotels/{hotelId}/controlSegments/{controlSegmentCode}` | Delete a Control Segment |
| PUT | `/hotels/{hotelId}/controlSegments/{controlSegmentCode}` | Modify a Control Segment |
| DELETE | `/hotels/{hotelId}/massRateChangeLog` | Delete mass rate change log |
| GET | `/hotels/{hotelId}/massRateChangeStatus` | Get mass rate change status |
| PUT | `/hotels/{hotelId}/massRatePlanSchedules` | Set mass rate plan schedules |
| GET | `/hotels/{hotelId}/negotiatedRates` | Get negotiated rates and profiles |
| POST | `/hotels/{hotelId}/negotiatedRates` | Create negotiated rates |
| PUT | `/hotels/{hotelId}/negotiatedRates/distributions` | Distribute negotiated rates |
| PUT | `/hotels/{hotelId}/negotiatedRates/{rateCode}` | Change negotiated rates |
| GET | `/hotels/{hotelId}/negotiatedRates/{rateCode}/profiles` | Fetch Negotiated Rates |
| GET | `/hotels/{hotelId}/packageForecastGroups` | Get Hotel Package Forecast Groups |
| POST | `/hotels/{hotelId}/packageForecastGroups` | Create Hotel Package Forecast Groups |
| PUT | `/hotels/{hotelId}/packageForecastGroups` | Change Hotel Package Forecast Groups |
| DELETE | `/hotels/{hotelId}/packageForecastGroups` | Delete Hotel Package Forecast Groups |
| GET | `/hotels/{hotelId}/packageFormulaRanges` | Get package formula ranges |
| POST | `/hotels/{hotelId}/packageFormulaRanges` | Create package formula ranges |
| PUT | `/hotels/{hotelId}/packageFormulaRanges/{packageFormulaRangeId}` | Change package formula ranges |
| DELETE | `/hotels/{hotelId}/packageFormulaRanges/{packageFormulaRangeId}` | Delete package formula ranges |
| GET | `/hotels/{hotelId}/packageGroups` | Get package groups |
| POST | `/hotels/{hotelId}/packageGroups` | Create package group |
| PUT | `/hotels/{hotelId}/packageGroups` | Change package group |
| DELETE | `/hotels/{hotelId}/packageGroups/{packageCode}` | Delete package group |
| GET | `/hotels/{hotelId}/packages/{packageCode}` | Get package for given package |
| POST | `/hotels/{hotelId}/packages/{packageCode}` | Create package |
| PUT | `/hotels/{hotelId}/packages/{packageCode}` | Change the package |
| DELETE | `/hotels/{hotelId}/packages/{packageCode}` | Delete the package |
| GET | `/hotels/{hotelId}/packages/{packageCode}/rates` | Get package rates |
| POST | `/hotels/{hotelId}/packages/{packageCode}/text` | Generate package description with AI Author Service Proxy |
| DELETE | `/hotels/{hotelId}/profiles/{profileId}/startDate/{startDate}/negotiatedRates/{ratePlanId}` | Delete negotiated rates |
| GET | `/hotels/{hotelId}/promotionCodes` | Get promotion codes |
| PUT | `/hotels/{hotelId}/promotionCodes/{promotionCode}` | Change promotion codes |
| POST | `/hotels/{hotelId}/promotionCodes/{promotionCode}` | Create promotion codes |
| POST | `/hotels/{hotelId}/promotionCodes/{promotionCode}/coupons` | Generate promotion coupon codes |
| GET | `/hotels/{hotelId}/promotionCodes/{promotionCode}/coupons` | Get promotion coupon codes |
| PUT | `/hotels/{hotelId}/promotionCodes/{promotionCode}/coupons/{couponId}` | Update promotion coupon codes |
| GET | `/hotels/{hotelId}/promotionCodes/{promotionCode}/coupons/{couponId}` | Get promotion coupon code |
| GET | `/hotels/{hotelId}/promotionGroups` | Get promotion groups |
| PUT | `/hotels/{hotelId}/promotionGroups/copy` | Copy promotion groups |
| PUT | `/hotels/{hotelId}/promotionGroups/{groupCode}` | Change promotion groups |
| POST | `/hotels/{hotelId}/promotionGroups/{groupCode}` | Create promotion groups |
| DELETE | `/hotels/{hotelId}/promotionGroups/{groupCode}` | Delete promotion groups |
| PUT | `/hotels/{hotelId}/rateAccessExclusions` | Set rate access exclusions |
| DELETE | `/hotels/{hotelId}/rateAccessExclusions` | Delete rate access exclusions |
| GET | `/hotels/{hotelId}/rateGroups` | Get rate groups |
| PUT | `/hotels/{hotelId}/rateGroups` | Change rate groups |
| POST | `/hotels/{hotelId}/rateGroups` | Create rate groups |
| DELETE | `/hotels/{hotelId}/rateGroups` | Delete rate groups |
| GET | `/hotels/{hotelId}/ratePlan/schedule/yieldAdjustment` | Get rate plan schedule yield adjustments |
| POST | `/hotels/{hotelId}/ratePlanSchedules/{scheduleId}/split` | Split rate plan schedule |
| GET | `/hotels/{hotelId}/ratePlans` | Get rate plans by Hotel Code |

…and 52 more operations. They are listed in full on the page.

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/openapi/oracle-hospitality-rate-plan-api-openapi.yml
- **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

## Other Oracle Hospitality APIs (12)

- [OPERA Cloud RnA Activities GraphQL API](https://apis.io/apis/oracle-hospitality/opera-cloud-rna-activities/)
- [OPERA Cloud RnA ARAccountsReceivable GraphQL API](https://apis.io/apis/oracle-hospitality/opera-cloud-rna-ar-accounts-receivable/)
- [OPERA Cloud RnA ARAgingReport GraphQL API](https://apis.io/apis/oracle-hospitality/opera-cloud-rna-ar-aging-report/)
- [OPERA Cloud RnA ARLedger GraphQL API](https://apis.io/apis/oracle-hospitality/opera-cloud-rna-ar-ledger/)
- [OPERA Cloud RnA BookingReservationExtended GraphQL API](https://apis.io/apis/oracle-hospitality/opera-cloud-rna-booking-reservation-extended/)
- [OPERA Cloud RnA BookingsBlockProductionChanges GraphQL API](https://apis.io/apis/oracle-hospitality/opera-cloud-rna-bookings-block-production-changes/)
- [OPERA Cloud RnA BookingsBlockStatusChanges GraphQL API](https://apis.io/apis/oracle-hospitality/opera-cloud-rna-bookings-block-status-changes/)
- [OPERA Cloud RnA BookingsBlock GraphQL API](https://apis.io/apis/oracle-hospitality/opera-cloud-rna-bookings-block/)
- [OPERA Cloud RnA BookingsReservation GraphQL API](https://apis.io/apis/oracle-hospitality/opera-cloud-rna-bookings-reservation/)
- [OPERA Cloud RnA CateringEventForecast GraphQL API](https://apis.io/apis/oracle-hospitality/opera-cloud-rna-catering-event-forecast/)
- [OPERA Cloud RnA CateringEventPostings GraphQL API](https://apis.io/apis/oracle-hospitality/opera-cloud-rna-catering-event-postings/)
- [OPERA Cloud RnA CateringEventStatusChanges GraphQL API](https://apis.io/apis/oracle-hospitality/opera-cloud-rna-catering-event-status-changes/)

## Tags

Rate Plan

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/oracle-hospitality/oracle-hospitality-rate-plan-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/oracle-hospitality/.