Oracle Hospitality

Oracle Hospitality Profile Configuration API

APIs for Customer Relationship Management (profile) configuration including preference groups and preferences.

GitHub OpenAPI

Operations 50

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

GET /addressFormats Look up configured address formats · Get address formats #
Ask an LLM
“Which address formats are set up for guest profiles in OPERA Cloud?”
“Can I find address formats by a partial code match?”
Tell an agent
Show me the address formats with codes {codes}.
List every address format configured for profiles.
PUT /addressFormats Update existing address formats · Change address formats #
Ask an LLM
“How do I change the layout of an address format that already exists?”
“Is it possible to edit several existing address formats in one request?”
Tell an agent
Update the existing address formats with these changes: {formats}.
Change the field order on our current address format definitions.
DELETE /addressFormats Delete address formats · Delete address formats #
Ask an LLM
“How do I remove address formats we no longer use?”
“Can I delete more than one address format by its code at once?”
Tell an agent destructive · confirm first
Delete the address formats with codes {formatCodes}.
Remove address format {formatCodes} from configuration.
POST /addressFormats Create new address formats · Create address formats #
Ask an LLM
“How can I add a new address format for a country we just started serving?”
“What do I send to define a brand-new address format for profiles?”
Tell an agent
Create new address formats {formats}.
Add a new address format definition to profile configuration.
GET /claimAdjustmentLimits Look up claim adjustment limits (deprecated) · Get Claim Adjustment Limits #
Ask an LLM
“What claim adjustment limits are configured for a property?”
“Can I still read claim adjustment limits even though the endpoint is deprecated?”
Tell an agent
Show claim adjustment limits for hotel {hotelId}.
Get the claim adjustment limits with codes {limitCodes}.
PUT /claimAdjustmentLimits Change existing claim adjustment limits · Change Claim Adjustment Limits #
Ask an LLM
“How do I modify claim adjustment limits that are already configured?”
“Is the change endpoint for claim adjustment limits deprecated?”
Tell an agent
Change the existing claim adjustment limits to {claimAdjustmentLimits}.
Edit our current claim adjustment limit amounts using the deprecated change endpoint.
POST /claimAdjustmentLimits Create new claim adjustment limits · Create Claim Adjustment Limits #
Ask an LLM
“How can I set up a new claim adjustment limit?”
“What does it take to add claim adjustment limits that don't exist yet?”
Tell an agent
Create claim adjustment limits {claimAdjustmentLimits}.
Add a brand-new claim adjustment limit through the deprecated create endpoint.
PUT /upsert/claimAdjustmentLimits Create or update claim adjustment limits · Create/Change Claim Adjustment Limits #
Ask an LLM
“Can I create a claim adjustment limit or update it if it already exists in one call?”
“Is there an upsert for claim adjustment limits?”
Tell an agent
Upsert claim adjustment limits {claimAdjustmentLimits}, creating any that are missing.
Create or overwrite our claim adjustment limits in a single upsert.
GET /creditRatings Look up credit rating codes · Get credit ratings #
Ask an LLM
“What credit rating codes can be assigned to profiles?”
“Can I include inactive credit ratings when I list them?”
Tell an agent
List credit ratings including inactive ones.
Find credit ratings whose description matches {description}.
PUT /creditRatings Update existing credit ratings · Change credit ratings #
Ask an LLM
“How do I edit the description of a credit rating that already exists?”
“Can I deactivate an existing credit rating code?”
Tell an agent
Update the existing credit ratings with {creditRatings}.
Change the settings on our current credit rating codes.
DELETE /creditRatings Delete credit ratings · Delete credit ratings #
Ask an LLM
“How do I remove a credit rating code we no longer use?”
“Can several credit ratings be deleted in one call?”
Tell an agent destructive · confirm first
Delete credit ratings {creditRatings}.
Remove the credit rating code {creditRatings} from configuration.
POST /creditRatings Create new credit ratings · Create credit ratings #
Ask an LLM
“How can I add a new credit rating code for profiles?”
“What do I need to define a new credit rating?”
Tell an agent
Create credit ratings {creditRatings}.
Add a new credit rating code to profile configuration.
GET /exclusivePreferences Look up template exclusive preferences · Get template Exclusive Preferences #
Ask an LLM
“Which exclusive preferences are defined at the template level?”
“Can I filter template exclusive preferences by preference group?”
Tell an agent
Show template exclusive preferences in preference groups {preferenceGroupsCodes}.
Get template exclusive preferences with codes {exclusivePreferenceCodes}.
PUT /exclusivePreferences Update template exclusive preferences · Change template Exclusive Preferences #
Ask an LLM
“How do I change an exclusive preference in the template, not at a hotel?”
“Can I edit which preferences are mutually exclusive in the template?”
Tell an agent
Update the template exclusive preferences with {templateExclusivePreferences}.
Change an existing template-level exclusive preference rule.
DELETE /exclusivePreferences Delete a template exclusive preference · Delete template Exclusive Preferences #
Ask an LLM
“How do I remove an exclusive preference from the template?”
“What identifies a template exclusive preference when deleting it?”
Tell an agent destructive · confirm first
Delete template exclusive preference {exclusivePreferenceCode} in group {exclusivePreferenceGroup}.
Remove the template-level exclusive preference {exclusivePreferenceCode} from group {exclusivePreferenceGroup}.
POST /exclusivePreferences Create template exclusive preferences · Create template Exclusive Preferences #
Ask an LLM
“How can I add a new exclusive preference to the template for all properties?”
“What do I send to create a template exclusive preference?”
Tell an agent
Create template exclusive preferences {templateExclusivePreferences}.
Add a new exclusive preference at the template level.
PUT /exclusivePreferences/copy Copy exclusive preferences · Copy Exclusive Preferences #
Ask an LLM
“Can I copy exclusive preferences from the template to other hotels?”
“How do I duplicate exclusive preference setup instead of recreating it?”
Tell an agent
Copy exclusive preferences using these copy instructions: {copyInstructions}.
Duplicate our exclusive preference setup to another property.
GET /hotels/{hotelId}/exclusivePreferences List a hotel's exclusive preferences · Get Exclusive preferences #
Ask an LLM
“Which exclusive preferences are configured at a specific hotel?”
“Can I see a property's exclusive preferences for certain preference codes only?”
Tell an agent
Show the exclusive preferences configured at hotel {hotelId}.
Get hotel {hotelId} exclusive preferences for preference codes {preferenceCodes}.
PUT /hotels/{hotelId}/exclusivePreferences Update a hotel's exclusive preferences · Change Exclusive Preferences #
Ask an LLM
“How do I change an exclusive preference rule at one property?”
“Can I edit hotel-level exclusive preferences without touching the template?”
Tell an agent
Update exclusive preferences at hotel {hotelId} with {hotelExclusivePreferences}.
Change an existing exclusive preference at property {hotelId}.
DELETE /hotels/{hotelId}/exclusivePreferences Delete an exclusive preference at a hotel · Delete Exclusive Preferences #
Ask an LLM
“How do I remove an exclusive preference from one hotel only?”
“What do I need to delete a hotel-level exclusive preference?”
Tell an agent destructive · confirm first
Delete exclusive preference {exclusivePreferenceCode} in group {exclusivePreferenceGroup} at hotel {hotelId}.
Remove hotel {hotelId}'s exclusive preference {exclusivePreferenceCode} from group {exclusivePreferenceGroup}.
POST /hotels/{hotelId}/exclusivePreferences Create exclusive preferences at a hotel · Create Exclusive Preferences #
Ask an LLM
“How can I add a new exclusive preference for a single property?”
“What do I send to create hotel-level exclusive preferences?”
Tell an agent
Create exclusive preferences {hotelExclusivePreferences} at hotel {hotelId}.
Add a new exclusive preference rule to property {hotelId}.
GET /hotels/{hotelId}/preferences List a hotel's configured guest preferences · Get preferences #
Ask an LLM
“What guest preferences are configured at a particular hotel?”
“Can I see which user created a hotel's preferences?”
Tell an agent
List all guest preferences configured at hotel {hotelId}.
Show hotel {hotelId} preferences in groups {preferenceGroupsCodes}.
PUT /hotels/{hotelId}/preferences Update a hotel's guest preferences · Change preferences #
Ask an LLM
“How do I change an existing guest preference at one property?”
“Can I rename a preference that's already configured at a hotel?”
Tell an agent
Update the preferences at hotel {hotelId} with {hotelPreferences}.
Change the existing guest preferences configured at property {hotelId}.
DELETE /hotels/{hotelId}/preferences Delete a guest preference at a hotel · Delete preferences #
Ask an LLM
“How do I remove a guest preference from a specific hotel's configuration?”
“Which values identify a hotel preference I want to delete?”
Tell an agent destructive · confirm first
Delete guest preference {preferenceCode} from group {preferenceGroup} for property {hotelId}.
Remove hotel {hotelId}'s preference {preferenceCode} from group {preferenceGroup} using the hotel endpoint.
POST /hotels/{hotelId}/preferences Create guest preferences at a hotel · Create preferences #
Ask an LLM
“How can I add a new guest preference, like a pillow type, for one hotel?”
“What do I send to create preferences at the hotel level?”
Tell an agent
Create preferences {hotelPreferences} at hotel {hotelId}.
Add a new guest preference option to property {hotelId}.
DELETE /preference Delete a global or hotel preference · Delete preferences #
Ask an LLM
“Can one call delete a preference at either the global level or a hotel level?”
“How do I remove a global preference that isn't tied to a property?”
Tell an agent destructive · confirm first
Delete the global preference {preferenceCode} in group {preferenceGroup}.
Using the combined global-and-hotel delete, remove preference {preferenceCode} in group {preferenceGroup} for hotel {hotelId}.
GET /preferenceGroups Look up preference groups · Get Preference Groups #
Ask an LLM
“What preference groups exist for organizing guest preferences?”
“Can I search preference groups with a wildcard?”
Tell an agent
Show preference groups with codes {preferenceGroupsCodes}.
List all preference groups.
PUT /preferenceGroups Update preference groups · Change Preference Groups #
Ask an LLM
“How do I modify several preference groups at the same time?”
“Can I change the description of an existing preference group?”
Tell an agent
Update preference groups with {preferenceGroups}.
Change the settings of our existing preference groups.
DELETE /preferenceGroups Delete a preference group · Delete preference groups #
Ask an LLM
“How do I remove a preference group we no longer need?”
“What code do I pass to delete a preference group?”
Tell an agent destructive · confirm first
Delete preference group {preferenceGroup}.
Remove the {preferenceGroup} preference group entirely.
POST /preferenceGroups Create a preference group · Create new preference groups #
Ask an LLM
“How can I add a new preference group, such as room features?”
“What do I send to create a preference group?”
Tell an agent
Create preference groups {preferenceGroups}.
Add a new preference group for guest preferences.
GET /preferences Look up template preferences · Get template Preferences #
Ask an LLM
“Which preferences are defined in the template rather than at a hotel?”
“Can I filter template preferences by group code?”
Tell an agent
Show template preferences in groups {preferenceGroupsCodes}.
Get template preferences with codes {preferenceCodes}.
PUT /preferences Update template preferences · Change template preferences #
Ask an LLM
“How do I change a preference in the template used across properties?”
“Can I edit existing template preferences in bulk?”
Tell an agent
Update template preferences with {templatePreferences}.
Change the existing template-level guest preferences.
DELETE /preferences Delete a template preference · Delete template preferences #
Ask an LLM
“How do I remove a preference from the template?”
“What do I pass to delete a template-level preference?”
Tell an agent destructive · confirm first
Delete template preference {preferenceCode} in group {preferenceGroup}.
Remove {preferenceCode} from the template preferences in group {preferenceGroup}.
POST /preferences Create template preferences · Create template preferences #
Ask an LLM
“How can I add a new preference to the template for every property?”
“What do I send to create template preferences?”
Tell an agent
Create template preferences {templatePreferences}.
Add a new guest preference at the template level.
PUT /preferences/copy Copy guest preferences · Copy preferences #
Ask an LLM
“Can I copy guest preferences from the template to other hotels?”
“How do I duplicate a set of preferences instead of creating each one again?”
Tell an agent
Copy preferences using these copy instructions: {copyInstructions}.
Duplicate our guest preference setup to another property.
GET /profileNameValidations Look up profile name validations · Get Profile Name Validations #
Ask an LLM
“What profile name validation rules are configured?”
“Can I look up name validations for a specific profile type?”
Tell an agent
Show profile name validations for profile types {typeCodes}.
Find the name validation rule for the name {name}.
PUT /profileNameValidations Update profile name validations · Change Profile Name Validations #
Ask an LLM
“How do I change an existing profile name validation rule?”
“Can I edit several name validations at once?”
Tell an agent
Update profile name validations with {profileNames}.
Change our existing profile name validation entries.
DELETE /profileNameValidations Delete a profile name validation · Delete Profile Name Validations #
Ask an LLM
“How do I remove a name validation for a given profile type?”
“What identifies a profile name validation when deleting it?”
Tell an agent destructive · confirm first
Delete the name validation for {profileName} on profile type {profileType}.
Remove profile name validation {profileName} from {profileType} profiles.
POST /profileNameValidations Create profile name validations · Create Profile Name Validations #
Ask an LLM
“How can I add a new name validation rule for profiles?”
“What do I send to create profile name validations?”
Tell an agent
Create profile name validations {profileNames}.
Add a new profile name validation entry.
PUT /upsert/profileNameValidations Create or update profile name validations · Create/Change Profile Name Validations #
Ask an LLM
“Is there an upsert for profile name validations?”
“Can I create a name validation or overwrite it if it exists in one call?”
Tell an agent
Upsert profile name validations {profileNames}.
Create or update our profile name validations in a single upsert.
GET /relationships Look up profile relationship types · Get profile relationships #
Ask an LLM
“Which relationship types can connect two profiles, like company to guest?”
“Can I list profile relationships for a given pair of profile types?”
Tell an agent
Show profile relationships from {fromType} profiles to {toType} profiles.
List all configured profile relationship types.
PUT /relationships Update profile relationship types · Change profile relationships #
Ask an LLM
“How do I change an existing profile relationship definition?”
“Can I edit several profile relationships in one request?”
Tell an agent
Update profile relationships with {profileLinks}.
Change our existing profile relationship definitions.
DELETE /relationships Delete a profile relationship type · Delete profile relationships #
Ask an LLM
“How do I remove a relationship type between two profile types?”
“What codes do I need to delete a profile relationship?”
Tell an agent destructive · confirm first
Delete the profile relationship from {fromType} {fromCode} to {toType} {toCode}.
Remove relationship {fromCode} to {toCode} between {fromType} and {toType} profiles.
POST /relationships Create profile relationship types · Create profile relationships #
Ask an LLM
“How can I define a new relationship type between profiles?”
“What do I send to create profile relationships?”
Tell an agent
Create profile relationships {profileLinks}.
Add a new relationship type linking two kinds of profiles.
GET /services/profile/status Check profile configuration service health · ping #
Ask an LLM
“Is the profile configuration service up right now?”
“How can I ping the profile configuration service?”
Tell an agent
Ping the profile configuration service.
Check the profile configuration service status while signed in to hotel {hotel}.
PUT /upsert/relationships Create or update profile relationships · Create/Change profile relationships #
Ask an LLM
“Is there an upsert for profile relationship types?”
“Can I create a profile relationship or update it if it exists in one call?”
Tell an agent
Upsert profile relationships {profileLinks}.
Create or overwrite our profile relationships in a single upsert.

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-profileconfiguration-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-profileconfiguration-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-profileconfiguration-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: OPERA Cloud CRM Configuration Profile Configuration API
  description: APIs for Customer Relationship Management (profile) configuration, such as creating preferences, or address types.
  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: /crm/config/v1
tags:


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