Releases: oracle/hospitality-api-docs
Release list
26.2
Oracle Hospitality API docs version 26.2
API specifications updates
- OPERA Cloud Property 26.2 API specifications added. See release notes, resolved Issues, and deprecated features.
- OPERA Cloud Distribution 26.2 specifications added. See release notes and resolved Issues.
- NOR1 26.2 specifications added. See release notes.
- Data APIs 26.1 specifications added. See release notes and resolved issues.
Platform features
For information on the Oracle Hospitality Integration Platform v26.1 features see release notes.
Major changes
Please note the following major changes to APIs. The ReadMe files indicate the change, timeline, and actions that need to be taken.
| Announcement Date | Link to ReadMe | Additional Information |
|---|---|---|
| 25-Sep-2023 | September 2023 ReadMe | |
| 30-Apr-2024 | April 2024 ReadMe | RESTAPI_Limits |
| 21-May-2024 | May 2024 ReadMe | |
| 15-July-2024 | July 2024 ReadMe | |
| 9-Sept-2024 | September 2024 ReadMe | |
| 17-March-2025 | March 2025 ReadMe | |
| 10-June-2025 | June 2025 ReadMe | |
| 27-October-2025 | October 2025 ReadMe | |
| 4-February-2026 | February 2026 ReadMe | Legacy and New API Operation IDs and Endpoints |
v25.5
Oracle Hospitality API docs version 25.5
API specifications updates
- OPERA Cloud Property 25.5 API specifications added. See release notes, resolved Issues, and deprecated features.
- OPERA Cloud Distribution 25.5 specification added. See See release notes and resolved Issues.
- Oracle Hospitality Data APIs v25.5 specifications added. Release notes:
New APIs added for the following Subject Areas
- Promotion Coupon Codes
- Integration Configurations
Created new APIs which include grouped information. For example, BookingReservationExtended includes details of the reservation, reservation details, block details, financial details, and changes log, all of which can be obtained from this one Extended API instead of joining across multiple APIs/subject areas.
- BookingReservationExtended
- FinancialTransactionDetailsExtended
For the following APIs, key filter parameters which were all mandatory are now grouped. One parameter must be chosen from group 1 then one or more parameters from group 2:
- Bookings Reservation
- Booking Block
- Financial Transactions
- Catering Event and Resources
For example, when retrieving bookings/reservations either a resort code or a chain code is required in group 1, but bookings/reservations can then be fetched by either arrival date, departure date, or any other parameter in group 2.
For a fuller explanation of groups 1 and 2 see the BookingsReservation schema and the equivalents in other specifications.
Platform features
For information on the Oracle Hospitality Integration Platform v25.4 features see release notes.
Major changes
Please note the following major changes to APIs. The ReadMe files indicate the change, timeline, and actions that need to be taken.
| Announcement Date | Link to ReadMe | Additional Information |
|---|---|---|
| 25-Sep-2023 | September 2023 ReadMe | |
| 30-Apr-2024 | April 2024 ReadMe | RESTAPI_Limits |
| 21-May-2024 | May 2024 ReadMe | |
| 15-July-2024 | July 2024 ReadMe | |
| 9-Sept-2024 | September 2024 ReadMe | |
| 17-March-2025 | March 2025 ReadMe | |
| 10-June-2025 | June 2025 ReadMe | |
| 27-October-2025 | October 2025 ReadMe | |
| 4-February-2025 | February 2026 ReadMe |
v25.4
Oracle Hospitality API docs version 25.4
API specifications updates
- OPERA Cloud Property 25.4 API specifications added. See release notes, resolved Issues, and deprecated features.
- OPERA Cloud Distribution 25.4 specification added. See See release notes and resolved Issues.
- Data APIs for access to Reporting and Analytics 25.4 Subject Areas. See user guide.
Postman updates
Postman collection added for Data APIs.
Postman samples added to the oracle-hospitality-property.postman_collection.json:
- Added to Event Management the operation get eventChangesByDateTime
- Added to Async APIs > Blocks the operation Block Recalculate Room Forecast
- Added to the LOV the operation get States
- Added the REPORT CONFIG collection
- Added to Reservations > Post Reservation > post Reservation an example of adding the Travel Agent Profile
- Added to the Cashiering the new operaiton Post ProFormaFolio
Enhancements Delivered in the Distribution REST API Sample Collection
Release 25.4 brings expanded coverage of Reservation, Shop, Content, and ARI workflows, along with new early-release capabilities. The updated Postman collection now includes new sample requests designed to accelerate partner development, clarify edge cases, and demonstrate new supported payload patterns.
1. Reservation API Enhancements (BOOK / RESERVATION)
New: Modify Reservation Scenarios
- Full modification with comment update
- Full modification with availability validation overlay
These additions illustrate complete end-to-end flows for reservation updates, including overlay processing and validation behaviors.
New: Early Release Reservation Samples
The collection now introduces the Distribution Reservation (EARLY RELEASE) API with four practical scenarios:
- Basic reservation creation
- Reservation with add-on packages
- Standalone inventory item reservation
- Reservation creation using Guest Profile ID
These samples help partners prepare for the upcoming unified reservation architecture.
2. Expanded Reservation Notification Scenarios (RESNOTIF)
25.4 adds new, highly requested guarantee and payment-type combinations:
- Travel Agent Guaranteed (19) + Voucher Payment (3)
- Company Guaranteed (29) + Direct Bill Payment (2)
And new capability samples:
- Add-on packages priced per adult
- Reservation Notification with OPERA Source / Origin codes
These samples provide clarity for downstream mappings and ensure reservation ingestion aligns with OPERA Cloud requirements.
3. Advanced Rate-Plan and Room-View Targeting in SHOP
New Search Behaviors
- Rate-plan-type filtering for requested rate only
- Range rules that guarantee Public rates are always returned
- Combined Public + Negotiated rate-plan range logic
New Offer-Level Filtering
- Targeting by specific OTA Room View Code
- Targeting by specific rate plan codes
These examples demonstrate more realistic OTA-style search patterns and help validate multi-rate, multi-view scenarios.
4. Content API Expansion (CONTENT)
New: Retrieve Specific Rate Plan With Cancel Policy
A new request illustrates how to retrieve a single rate plan, including cancel policy, while supporting negotiated rate visibility.
5. New ARI Publication Scenarios (SPECIFICATIONS)
The ARI section has been enhanced with realistic publication payloads:
- Tax Exclusive rate updates (amountBeforeTax)
- Tax Inclusive rate updates (amountAfterTax)
- Full Pattern LOS (FPLOS) – explicit pattern-based restriction example
These samples support certification, troubleshooting, and partner education for modern ARI behavior.
Platform features
For information on the Oracle Hospitality Integration Platform v25.4 features see release notes.
Major changes
Please note the following major changes to APIs. The ReadMe files indicate the change, timeline, and actions that need to be taken.
| Announcement Date | Link to ReadMe | Additional Information |
|---|---|---|
| 25-Sep-2023 | September 2023 ReadMe | |
| 30-Apr-2024 | April 2024 ReadMe | RESTAPI_Limits |
| 21-May-2024 | May 2024 ReadMe | |
| 15-July-2024 | July 2024 ReadMe | |
| 9-Sept-2024 | September 2024 ReadMe | |
| 17-March-2025 | March 2025 ReadMe | |
| 10-June-2025 | June 2025 ReadMe | |
| 27-October-2025 | October 2025 ReadMe |
v25.1
Oracle Hospitality API docs version 25.1
API specifications updates
- OPERA Cloud Property 25.1 API specifications added. See release notes, resolved Issues, and deprecated features.
- OPERA Cloud Distribution 25.1 API specifications added. See release notes and resolved Issues.
Postman updates
- Added samples for the new Distribution Onboarding API, Distribution Property Controls API, as well as the outbound APIs Distribution Outbound Lookup, and Distribution Outbound Content Notification
- Updated the year in Postman samples to 2025
Platform features
For information on the Oracle Hospitality Integration Platform v25.1 features see release notes.
Major changes
Please note the following major changes to APIs. The ReadMe files indicate the change, timeline, and actions that need to be taken.
Note: The links are to the Oracle Hospitality Customer Support portal. First-time users must register at the Customer Support Portal. For more information about the Customer Support Portal, click the "Getting Started With Support" tile on the Customer Support Portal's main page. You will need your CSI number from your Cloud administrator's welcome email. If you have not yet received that email please ensure you have access to the Oracle Hospitality Integration Platform - see getting started guide.
| Announcement Date | Link to ReadMe | Additional Information |
|---|---|---|
| 25-Sep-2023 | September 2023 ReadMe | |
| 30-Apr-2024 | April 2024 ReadMe | RESTAPI_Limits |
| 21-May-2024 | May 2024 ReadMe | |
| 15-July-2024 | July 2024 ReadMe | |
| 9-Sept-2024 | September 2024 ReadMe | |
| 8-Oct-2024 | October 2024 ReadMe | |
| 17-Mar-2025 | March 2025 ReadMe |
v24.4
Oracle Hospitality API docs version 24.4
API specifications updates
- OPERA Cloud Property 24.4 API specifications added. See release notes, resolved Issues, and deprecated features.
Updated the Distribution Postman collection to version 24.3.0.0
- Added documentation on every sample request
- Included sample responses
- Added visualizers to requests
- Created separate Postman environment just for ORACLE Hospitality Distribution APIs
Postman updates
- Re-organized Postman collections folder by product
- Adjusted Property Workflows collection to move all calls to v1
- Added Postman collection and environment for generating the download link for Reporting and Analytics - refer to this Oracle Support document
Platform features
For information on the Oracle Hospitality Integration Platform v24.3 features see release notes.
v24.2
Oracle Hospitality API docs version 24.2
API specifications updates
- OPERA Cloud Property 24.2 API specifications added. See release notes, resolved Issues, and deprecated features.
- OPERA Cloud Distribution 24.3 specification added. See below.
Updated the Distribution APIs to version 24.3.0.0
- The Distribution Shop API now returns restrictions in the response payload.
- The Distribution Book and Distribution Reservation Notification APIs now accept payment tokens as well as payment card details.
- The Distribution Authentication API now supports Opera Cloud Identity Manager tokens.
Postman updates
- Re-organized Postman collections folder by product
- Adjusted Property Workflows collection to move all calls to v1
- Added Postman collection and environment for generating the download link for Reporting and Analytics - refer to this Oracle Support document
Platform features
For information on the Oracle Hospitality Integration Platform v24.3 features see release notes.
Major changes
Please note the following major changes to APIs. The ReadMe files indicate the change, timeline, and actions that need to be taken.
Note: The links are to the Oracle Hospitality Customer Support portal. First-time users must register at the Customer Support Portal. For more information about the Customer Support Portal, click the "Getting Started With Support" tile on the Customer Support Portal's main page. You will need your CSI number from your Cloud administrator’s welcome email. If you have not yet received that email please ensure you have access to the Oracle Hospitality Integration Platform - see getting started guide.
| Announcement Date | Link to ReadMe | Additional Information |
|---|---|---|
| 25-Sep-2023 | September 2023 ReadMe | |
| 30-Apr-2024 | April 2024 ReadMe | RESTAPI_Limits |
| 21-May-2024 | May 2024 ReadMe | |
| 15-July-2024 | July 2024 ReadMe | |
| 9-Sept-2024 | September 2024 ReadMe | |
| 8-Oct-2024 | October 2024 ReadMe |
v24.1
Oracle Hospitality API docs version 24.1
API specifications updates
- OPERA Cloud Property 23.5 API specifications added. See release notes and resolved Issues.
- OPERA Cloud Distribution 23.5 ARI specification added. See release notes.
Postman updates
- Added 171 request samples to the Property and 20 to the Distribution Postman collection, which are now also available on Postman.com.
- Added visualizers to the Distribution Postman request samples to more easily visualize the responses.
- Expanded the Property Asynchronous APIs folder with many samples explaining different payloads needed for different goals.
- Added variables to the Postman environment file for variables used within the collections.
Platform features
For information on the Oracle Hospitality Integration Platform v24.1 features see release notes.
Major changes
Please note the following major changes to APIs. The ReadMe files indicate the change, timeline, and actions that need to be taken.
Note: The links are to the Oracle Hospitality Customer Support portal. First-time users must register at the Customer Support Portal. For more information about the Customer Support Portal, click the "Getting Started With Support" tile on the Customer Support Portal's main page. You will need your CSI number from your Cloud administrator’s welcome email. If you have not yet received that email please ensure you have access to the Oracle Hospitality Integration Platform - see getting started guide.
| Announcement Date | Link to ReadMe | Additional Information |
|---|---|---|
| 25-Sep-2023 | September 2023 ReadMe | |
| 30-Apr-2024 | April 2024 ReadMe | RESTAPI_Limits |
| 21-May-2024 | May 2024 ReadMe |