How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

OPERA Cloud Inventory API

APIs to cater for Inventory functionality in OPERA Cloud. This includes sell limits for date ranges, viewing and updating the properties inventory, as well as item inventory (such as rollaways, microwaves etc.). Compatible with OPERA Cloud release 26.2.0.0. 13 operation(s) documented; base path /inv/v1. Harvested verbatim from Oracle's public hospitality-api-docs repository (Swagger 2.0, release 26.2.0.0).

OPERA Cloud Inventory API is one of 135 APIs that Oracle Hospitality publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Inventory, INVStats, Property Management, and OPERA Cloud. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 13 operations across 11 paths, organized into 2 resource areas, and defines 76 schemas. It is described by OpenAPI 2.0, at version 26.2.0.0.

13 operations 11 paths 76 schemas 8 GET1 POST4 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
26.2.0.0
License
Terms of Service
Resource Areas
2

Paths & Operations 13

Across 11 paths, the API surfaces 13 operations — 8 GET, 1 POST, 4 PUT. They span 2 resource areas: INVStats, Inventory. Each is listed below with its method, path, parameters, and response codes.

INVStats 4

The Inventory Statistics APIs provide the ability to fetch hotels inventory statistics or block inventory statistics for a specified date range provided in the request. It also co…

GET
/blockInventoryStatistics
Get block inventory statistics for multiple hotel Ids
getBlockInventoryStatisticsMultipleHotelIds 33 params → 200204400401403404405406
GET
/hotels/{hotelId}/blockInventoryStatistics
Get block inventory statistics
getBlockInventoryStatistics 33 params → 200204400401403404405406
GET
/hotels/{hotelId}/inventoryStatistics
Get a hotels Inventory Statistics
getInventoryStatistics 14 params → 200204400401403404405406
GET
/services/invStatsService/status
Ping
pinginvStatsService 8 params → 200204400401403404405406
Inventory 9

The Inventory APIs provide the ability to fetch Hotel Room Type Inventory and manage overbooking/sell limits at different levels. It also contains operations to get item inventory…

GET
/hotels/{hotelId}/hotelInventory
Get hotel inventory
getHotelInventory 18 params → 200204400401403404405406
GET
/hotels/{hotelId}/itemInventory
Get item inventory
getItemInventory 25 params → 200204400401403404405406
POST
/hotels/{hotelId}/itemInventoryHold
Hold item inventory
postHoldItemInventory 10 params → 201400401403404405406413
GET
/hotels/{hotelId}/itemInventoryHold
Get items inventory that are held
getHoldItemsInventory 10 params → 200204400401403404405406
PUT
/hotels/{hotelId}/itemInventoryHold
update items inventory that are held
putHoldItemsInventory 10 params → 200400401403404405406413
PUT
/hotels/{hotelId}/sellLimits
Set sell limits by date
changeSellLimitByDate 10 params → 200400401403404405406413
PUT
/hotels/{hotelId}/sellLimitsByDateRange
Set sell limits by date range
changeSellLimitByDateRange 10 params → 200400401403404405406413
PUT
/releasedItemInventory
Release item inventory held
putItemInventoryHold 9 params → 200400401403404405406413
GET
/services/inventory/status
Ping
pingInventoryService 8 params → 200204400401403404405406

Schemas 76

The contract defines 76 schemas that model the data the API accepts and returns. The most detailed are blockInfoType (22 properties), poolItemInventoryCountsType (17 properties), itemInventoryCountsType (16 properties), sellMessageType (16 properties). Each schema is shown below with its type and property counts.

blockInventoryStatistic
object
Response object for information regarding Block Inventory Statistics.
3 properties
blockInventoryStatisticType
object
Summary and Detail statistics for block inventory.
3 properties
blockSummaryStatisticsType
array
Statistic units group by status, booking and daily targets.
blockSummaryStatisticType
object
Statistic units group by status, booking and daily targets.
4 properties
statusSummaryStatisticType
array
Statistic summary for a particular status.
statusStatisticType
object
List of statistic units for a particular status.
2 properties
statisticUnitType
object
Unit type to hold statistic code and value pair e.g. [code - value] [Definite - 20] [Sales Allowance - 30] and its sub units.
3 properties
statisticUnitsType
array
Unit type to hold statistic code and value pair.
blockDetailStatisticsType
array
Compose of block information and statistic summary for a particular block.
blockDetailStatisticType
object
Information and statistic summary for a particular block.
2 properties
blockInfoType
object
Contains information of the business block .
22 properties
uniqueID_Type
object
An identifier used to uniquely reference an object in a system (e.g. an airline reservation reference, customer profile reference, booking confirmation number,…
2 properties
codeDescriptionType
object
This contains a generic code and description information.
2 properties
statusColorType
string
Status code color configuration type.
blockRateProtectionType
object
Block Rate Protection code information.
2 properties
rateProtectionType
string
Simple type for specifying the block protection type.
datesType
array
Specifies a single date.
blockNonCompeteType
object
Block Non Compete code information.
4 properties
blockClassificationType
string
Simple type for block instructions to be used in requests for fetching blocks. Valid status values are MASTERBLOCK, MASTERTOUR, FITMASTER, MASTERALLOCATION, MA…
blockStatusStatisticsType
array
Summary statistics of a block for each date.
blockStatusStatisticType
object
Contains summary statistic for a block on a particular statistic date.
2 properties
sellMessagesType
object
The SellMessagesType is the list of message and attributes returned by web service.
4 properties
sellMessageType
object
The SellMessagesType defines the standard attributes that will be retrieved with the sell message.
16 properties
usedInModuleType
string
Simple type for indicating the module for which user wants to create the SellMessage. Valid module types are Look To Book Sales,Reservations,Blocks,Function Di…
links
array
instanceLink
object
Metadata describing link description objects that MAY appear in the JSON instance representation.
7 properties
warningsType
array
Used in conjunction with the Success element to define a business error.
warningType
object
Used when a message has been successfully processed to report any warnings or business errors that occurred.
10 properties
exceptionDetailType
object
Complex type that contains error details for a REST call.
9 properties 2 required
errorInstance
object
Complex type that contains error instance details for a REST call.
7 properties 2 required
hotelInventory
object
A response for Hotel Inventories meeting the search criteria. Returns inventory classified on room type, class and house level for a given property.
3 properties
hotelInventoryType
object
A collection of Reservation objects and Unique IDs of Reservation.
3 properties
inventoryCountsListType
array
Collection of Inventory counts for the date ranges.
inventoryCountsType
object
Inventory counts for the given date range.
5 properties
inventoryLevelCountsListType
object
Collection of Inventory counts for the date ranges.
3 properties
inventoryStatistics
array
List of inventory statistics that is grouped by statistic date.
statisticType
object
Defines all details needed to create a statistical report.
4 properties
statisticCodeType
object
Defines the codes and corresponding categories for which the data in the other elements has been gathered.
5 properties
statisticSetType
object
An instance of a statistic, which is a set containing revenue category and number category summaries.
4 properties
revenueCategorySummaryType
object
This element has revenue amount data for its revenue category such as Room Revenue, Food and Beverage Revenue.
3 properties
numericCategorySummaryType
object
This element has count data for each count category such as number of guests, rooms occupied, etc.
2 properties
itemInventory
object
Return object to the request for information regarding items inventory/availability.
3 properties
poolItemInventoryCountsListType
array
Items/Item pool with brief information and its Inventory counts for the given dates.
poolItemInventoryCountsType
object
Basic information regarding an Item.
17 properties
timeWindowType
object
Defines a Time period with startDate time and an endDate time.
2 properties
timeSpanType
object
Allows for a choice in description of the amount of time spanned by this type. EndDate specifies a specific date, while Duration provides a measure of time to…
3 properties
dailyItemInventoryCountsListType
array
Inventory counts for the given date.
dailyItemInventoryCountsType
object
Inventory counts for the given date.
3 properties
itemInventoryCountsListType
array
Provides item's brief information and a collection of Inventory counts for the given dates for the item.
itemInventoryCountsType
object
Basic information regarding an Item.
16 properties
holdItemInventory
object
Object containing the item hold details.
3 properties
holdItemInventoryType
object
Request parameter for holding an Item Inventory.
6 properties
heldByType
string
Type of the entity that is requesting for the item hold.
holdItemInfoListType
array
Info of an item inventory that is requested for Hold.
holdItemInfoType
object
Information about an item inventory that is requested for hold.
4 properties
status
object
Response Body.
2 properties
holdItemsInventory
object
Response object to fetch the item hold details.
3 properties
sellLimit
object
A Request message that sets sell limit for a particular date for all the levels House, room type and room class. The request can contain the number type in whi…
2 properties
sellLimitByDateType
object
This type is used by sell limit request.
4 properties
houseSellLimitType
object
3 properties
roomTypeSellLimitType
object
4 properties
roomClassSellLimitType
object
4 properties
sellLimitResponse
object
A Response object for setting sell limit by date.
2 properties
sellLimitByRange
object
A Request message that sets sell limit for collection of date ranges for either of the levels House, room type or room class. You can specify the days of the w…
2 properties
sellLimitByDateRangeType
object
This type is used by sell limit request for date ranges.
4 properties
sellLimitDateRangeType
object
12 properties
roomCodeCategoryType
string
Used for Room code type. eg. Code="RoomType" or "RoomClass"
sellLimitByDateResponse
object
A Response object for setting sell limit by date range.
2 properties
releaseItemInventoryHold
object
Request object for releasing a held item inventory/availability.
9 properties
codeType
string
Used for codes in the OPERA Code tables. Possible values of this pattern are 1, 101, 101.EQP, or 101.EQP.X.
releaseItemsInventoryHoldType
array
Collection of items for releasing an Items Inventory hold.
releaseItemInventoryHoldType
object
Item information for releasing an Item Inventory hold.
7 properties
releasedItemInventoryHeld
object
Response object for releasing item inventory hold.
2 properties
propertyStatisticUnitType
object
Unit type to hold statistic code and value pair e.g. [resort - value] [BHOTEL - 20] [MHOTEL - 30] and its sub units per property wise
2 properties
operaVersionNumberType
string
Current Opera Version Number
pingDetail
object
Response for Ping operation.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

oracle-hospitality-property-v1-inv.json Raw ↑

Other APIs Oracle Hospitality publishes across the network.

OPERA Cloud Distribution ARI Publication
OPERA Cloud Distribution Outbound Lookup
OPERA Cloud Distribution Content Notification
OPERA Cloud Distribution Book
OPERA Cloud Distribution Content
OPERA Cloud Distribution Property Controls
OPERA Cloud Distribution Reservation Service
OPERA Cloud Distribution Authentication API
OPERA Cloud Distribution Onboarding
OPERA Cloud Distribution Reservation Notification
OPERA Cloud Distribution Shop
Nor1 Integrated Upsell API
Where this information came from

This is an independent, third-party profile of OPERA Cloud Inventory API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.