Oracle Hospitality

Oracle Hospitality Block Async API

The Block Async Service Web Service provides capability to implement block related asynchronous operations in OPERA Cloud.

GitHub OpenAPI

Operations 21

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 /externalSystems/{extSystemCode}/hotels/{hotelId}/blocks/allocationSummary Request a hotel's block allocation summary · This API facilitates fetching block allocation summary for a Hotel #
Ask an LLM
“How can I pull group block allocations, rates and room type stats for a date range?”
“Can I request only blocks changed within a last-modified window?”
Tell an agent
Request the block allocation summary for hotel {hotelId} from {startDate} to {endDate} as system {extSystemCode}.
Start a block allocation summary for property {hotelId}, system {extSystemCode}, including net rates.
HEAD /externalSystems/{extSystemCode}/hotels/{hotelId}/blocks/allocationSummary/{requestId} Check if a block allocation summary is ready · This API returns the status of asynchronous process scheduled for given id #
Ask an LLM
“Is my block allocation summary request finished processing?”
“How do I poll a hotel-wide block allocation summary job?”
Tell an agent
Check whether block allocation summary {requestId} for hotel {hotelId} from {extSystemCode} is ready.
Poll allocation summary request {requestId} at property {hotelId}, system {extSystemCode}.
GET /externalSystems/{extSystemCode}/hotels/{hotelId}/blocks/allocationSummary/{requestId} Get a completed block allocation summary · This API returns a hotel's block allocation summary for a scheduled process #
Ask an LLM
“Where do I download the block allocation summary once the job is done?”
“What inventory and rate details come back in a finished block allocation summary?”
Tell an agent
Fetch block allocation summary {requestId} for hotel {hotelId} from system {extSystemCode}.
Show the allocated blocks returned by summary request {requestId} at property {hotelId}, system {extSystemCode}.
POST /hotels/{hotelId}/blocks/{blockId}/allocation Set room allocations and rates on a block · This API facilitates setting Block Allocations for a Hotel #
Ask an LLM
“How do I add room type allocations and rates to a group block?”
“Can I load a block's room inventory asynchronously?”
Tell an agent
Set room type allocations on block {blockId} at hotel {hotelId} using {criteria}.
Add allocated rooms and rates to group block {blockId} at property {hotelId}.
HEAD /hotels/{hotelId}/blocks/{blockId}/allocation/{requestId} Check if a block allocation update finished · This API returns the status of asynchronous process scheduled for given id #
Ask an LLM
“Is my block room allocation job complete?”
“How can I poll the set-allocation process on a block?”
Tell an agent
Check whether allocation job {requestId} on block {blockId} at hotel {hotelId} is done.
Poll the room allocation request {requestId} for block {blockId}, property {hotelId}.
GET /hotels/{hotelId}/blocks/{blockId}/allocation/{requestId} Get results of a block allocation update · This API returns information about the set allocation process #
Ask an LLM
“Did setting allocations on my block trigger any overbooking warnings?”
“Where do I see the outcome of a block room allocation job?”
Tell an agent
Show warnings from allocation job {requestId} on block {blockId} at hotel {hotelId}.
Fetch the overbooking results for block {blockId} allocation request {requestId} at property {hotelId}.
POST /hotels/{hotelId}/blocks/{blockId}/allocationRanges Set block allocations across date ranges · This API facilitates setting Block Allocation Ranges for a Hotel #
Ask an LLM
“How do I set a block's allocation for several date ranges and room types at once?”
“Can allocation ranges use a generic room type?”
Tell an agent
Set allocation ranges {allocationRanges} on block {blockId} at hotel {hotelId}.
Apply date-range allocations for generic room type {genericRoomType} on block {blockId} at property {hotelId}.
HEAD /hotels/{hotelId}/blocks/{blockId}/allocationRanges/{requestId} Check if a block allocation ranges job finished · This API returns the status of asynchronous process scheduled for given id #
Ask an LLM
“Is the allocation ranges update on my block still running?”
“How do I poll a date-range allocation job for a block?”
Tell an agent
Tell me if the multi-date-range allocation request {requestId} for block {blockId}, hotel {hotelId} has completed.
Poll date-range allocation request {requestId} for block {blockId}, property {hotelId}.
GET /hotels/{hotelId}/blocks/{blockId}/allocationRanges/{requestId} Get results of a block allocation ranges update · This API returns information about the set allocation ranges process #
Ask an LLM
“Were there overbooking warnings from setting date-range allocations on my block?”
“Where can I read the result of an allocation ranges job?”
Tell an agent
List overbooking warnings raised when date ranges were applied to block {blockId} at hotel {hotelId}, request {requestId}.
Fetch date-range allocation results {requestId} for block {blockId}, property {hotelId}.
POST /hotels/{hotelId}/blocks/{blockId}/shift Shift a block's dates · Shifts the Block start date #
Ask an LLM
“How do I move a group block to a new start date?”
“Can I shift the dates of an existing business block in OPERA?”
Tell an agent
Shift block {blockId} at hotel {hotelId} using {criteria}.
Move group block {blockId} at property {hotelId} to new dates.
HEAD /hotels/{hotelId}/blocks/{blockId}/shift/{requestId} Check if a block date shift finished · This API returns the status of asynchronous process scheduled for given id #
Ask an LLM
“Has my block date shift finished?”
“How can I poll a shift-block process?”
Tell an agent
Check whether shift job {requestId} on block {blockId} at hotel {hotelId} is done.
Poll the date-move request {requestId} for block {blockId}, property {hotelId}.
GET /hotels/{hotelId}/blocks/{blockId}/shift/{requestId} Get results of a block date shift · This API returns information about the shift block process #
Ask an LLM
“Did shifting my block's dates produce any errors or warnings?”
“Where do I see the outcome of a block shift?”
Tell an agent
Show errors and warnings from shift job {requestId} on block {blockId} at hotel {hotelId}.
Fetch date-move results {requestId} for block {blockId}, property {hotelId}.
POST /hotels/{hotelId}/blocks/{blockId}/recalculateRoomForecast Recalculate a block's forecast room rates · This API facilitates setting recalculation for forecast room rates in a… #
Ask an LLM
“How do I recalculate forecast room rates on a business block?”
“Can room forecast rates for a group be refreshed after pricing changes?”
Tell an agent
Recalculate forecast room rates for block {blockId} at hotel {hotelId}.
Start a room forecast recalculation on business block {blockId}, property {hotelId}.
HEAD /hotels/{hotelId}/blocks/{blockId}/recalculateRoomForecast/{requestId} Check if a room forecast recalculation finished · This API returns the status of asynchronous process scheduled for given id #
Ask an LLM
“Is the room forecast recalculation on my block done?”
“How do I poll a forecast rate recalculation job?”
Tell an agent
Check whether forecast recalculation {requestId} on block {blockId} at hotel {hotelId} is complete.
Poll room forecast recalculation request {requestId} for block {blockId}, property {hotelId}.
GET /hotels/{hotelId}/blocks/{blockId}/recalculateRoomForecast/{requestId} Get results of a room forecast recalculation · This API returns information about the recalculate room forecast rates process #
Ask an LLM
“Were there errors when recalculating my block's room forecast?”
“Where do I read the outcome of a forecast rate recalculation?”
Tell an agent
Show errors and warnings from forecast recalculation {requestId} on block {blockId} at hotel {hotelId}.
Fetch room forecast recalculation results {requestId} for block {blockId}, property {hotelId}.
POST /hotels/{hotelId}/blocks/{blockId}/refreshProjectedRevenues Refresh a block's projected revenues · This API facilitates refreshing projected revenues for a business block #
Ask an LLM
“How can I refresh projected revenue figures on a business block?”
“Is refreshing a group's projected revenues an async job?”
Tell an agent
Refresh projected revenues for block {blockId} at hotel {hotelId}.
Start a projected revenue refresh on business block {blockId}, property {hotelId}.
HEAD /hotels/{hotelId}/blocks/{blockId}/refreshProjectedRevenues/{requestId} Check if a projected revenue refresh finished · This API returns the status of asynchronous process scheduled for given id #
Ask an LLM
“Is the projected revenue refresh on my block complete?”
“How can I poll a projected revenues refresh job?”
Tell an agent
Check whether projected revenue refresh {requestId} on block {blockId} at hotel {hotelId} is done.
Poll projected revenue refresh request {requestId} for block {blockId}, property {hotelId}.
GET /hotels/{hotelId}/blocks/{blockId}/refreshProjectedRevenues/{requestId} Get results of a projected revenue refresh · This API returns information about the Business Block projected revenues… #
Ask an LLM
“Did refreshing projected revenues on my block return any errors?”
“Where do I see the outcome of a projected revenues refresh?”
Tell an agent
Show errors and warnings from projected revenue refresh {requestId} on block {blockId} at hotel {hotelId}.
Fetch projected revenue refresh results {requestId} for block {blockId}, property {hotelId}.
POST /hotels/{hotelId}/blocks/{blockId}/async Request a block's details asynchronously · Use this API to retrieve a Block by ID using an asynchronous process #
Ask an LLM
“How do I retrieve a large block by ID without the request timing out?”
“Can I fetch a block's allocated room types for a set number of days?”
Tell an agent
Start fetching block {blockId} at hotel {hotelId} asynchronously.
Request block {blockId} at hotel {hotelId} with allocated room types from {startDate} for {numberOfDays} days.
HEAD /hotels/{hotelId}/blocks/{blockId}/async/{requestId} Check if an async block fetch is ready · This API returns the status of asynchronous process scheduled for given id #
Ask an LLM
“Has my asynchronous block retrieval been processed yet?”
“How do I poll an async block fetch request?”
Tell an agent
Check whether async block fetch {requestId} for block {blockId} at hotel {hotelId} is ready.
Poll block retrieval request {requestId} for block {blockId}, property {hotelId}.
GET /hotels/{hotelId}/blocks/{blockId}/async/{requestId} Get a block fetched asynchronously · The API returns information about the block retrieval request #
Ask an LLM
“Where do I pick up the block details from my async fetch request?”
“What block information comes back once the async retrieval completes?”
Tell an agent
Get the block details from async fetch {requestId} for block {blockId} at hotel {hotelId}.
Show the retrieved block {blockId} from request {requestId}, property {hotelId}.

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-blockasync-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-blockasync-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-blockasync-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: OPERA Cloud Block Reservation Asynchronous Block Async API
  description: 'APIs to cater Block Reservation related asynchronous functionality in OPERA.


    Compatible with OPERA Cloud release 26.2.0.0.


    This document and all content within is available under the Universal Permissive License v 1.0 (https://oss.oracle.com/licenses/upl). Copyright (c) 2020, 2026 Oracle and/or its affiliates.'
  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: /blk/async/v1
tags:


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