Oracle Hospitality

Oracle Hospitality Profile External API

The Profile External module allows you to retrieve and manage profiles from an external system.

GitHub OpenAPI
Business capability
Guest Profile & Identity Management BC-4040.10

Operations 11

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 /externalSystems/{extSystemCode}/chains/{chainCode}/externalProfiles Search guest profiles in an external system · Retrieve profiles from external system #
Ask an LLM
“How do I look up a guest profile that lives in an external CRM or loyalty system?”
“Can I search external profiles by membership number or birth date?”
Tell an agent
Search external system {system} in chain {chain} for profiles named {name}.
Find the external profile with membership number {membership} in {system} for chain {chain}.
GET /externalSystems/{extSystemCode}/chains/{chainCode}/externalProfiles/{profileExternalId} Download a guest profile from an external system · Download a Profile from external system #
Ask an LLM
“Once I find a profile in the external system, how do I pull it into OPERA?”
“What ID do I need to download a single profile from an external database?”
Tell an agent
Download external profile {profile} from system {system} for chain {chain}.
Bring external profile {profile} from {system} into hotel {hotel} for chain {chain}.
GET /externalSystems/{extSystemCode}/playerStatistics/{profileId} Get a guest's gaming player statistics · Retrieve player statistics #
Ask an LLM
“Can I see casino player statistics for a hotel guest from the gaming system?”
“How do I look up player stats tied to a particular reservation?”
Tell an agent
Get player statistics for profile {profile} from gaming system {system}.
Show player {player} statistics for profile {profile} on reservation {reservation} via {system}.
GET /externalSystems/{extSystemCode}/gamingOffers/{membershipNo} List gaming offers available to a member · Get offers that can be attached for a profile #
Ask an LLM
“What casino offers can I attach to a guest's profile from the gaming system?”
“Can I limit gaming offers to a specific date window?”
Tell an agent
List gaming offers for membership {membership} from system {system}.
Get offers for member {membership} in {system} valid between {start} and {end}.
GET /hotels/{hotelId}/travelAgents/{iataNumber} Validate a travel agent's IATA number · Validate IATA number #
Ask an LLM
“How do I check whether a travel agent's IATA number is valid?”
“Is there a way to verify an IATA code before creating a travel agent profile?”
Tell an agent
Validate IATA number {iata} for hotel {hotel}.
Check that travel agent IATA {iata} is real at {hotel}.
GET /validatedAddresses Look up address suggestions from a validation vendor · Retrive valid addresses from a third party vendor #
Ask an LLM
“How do I get validated address suggestions for a guest's partially typed address?”
“Can I set a timeout on the third-party address lookup?”
Tell an agent
Find validated address matches for {address} in country {country}.
Suggest addresses for {address} in {country} in language {language}.
GET /validatedAddresses/{externalAddressId} Get the full address for a validated address ID · Get full Address information from third party system for a given external… #
Ask an LLM
“After picking an address suggestion, how do I get the complete address details?”
“What do I get back for one external address ID from the validation vendor?”
Tell an agent
Get the full address for validated address ID {address_id}.
Expand address suggestion {address_id} into its complete address.
GET /externalSystems/{extSystemCode}/chains/{chainCode}/validateMembershipNumber Validate a loyalty membership number externally · Validate Membership Number attached to a membership #
Ask an LLM
“How can I check a guest's membership number against the external loyalty system?”
“Does membership validation need the membership type as well as the number?”
Tell an agent
Validate membership number {membership} of type {type} with {system} for chain {chain}.
Check if {type} member {membership} exists in external system {system} for chain {chain}.
GET /services/profileExternal/status Check the ProfileExternal service status · Operation to check status of ProfileExternal service #
Ask an LLM
“Is the external profile service up and responding?”
“What version of the ProfileExternal service is running?”
Tell an agent
Ping the ProfileExternal service.
Check whether the external profile service is healthy for hotel {hotel}.
POST /validateEmail Validate an email address with a vendor · Validate email Id from a third party vendor #
Ask an LLM
“Can OPERA check whether a guest's email address is valid before I save it?”
“How long will the third-party email validation wait before timing out?”
Tell an agent
Validate the email address {email}.
Check {email} with the email validation vendor, timing out after {seconds} seconds.
POST /validatePhone Validate a phone number with a vendor · Validate phone number from a third party vendor #
Ask an LLM
“How do I confirm a guest's phone number is valid through a third-party service?”
“Can I set a timeout on phone number validation?”
Tell an agent
Validate the phone number {phone}.
Check phone {phone} with the validation vendor within {seconds} seconds.

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-profileexternal-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-profileexternal-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-profileexternal-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Oracle Hospitality Profile External API
  version: 26.2.0.0
  contact:
    email: hospitality_apis_ww_grp@oracle.com
  license:
    name: UPL
    url: https://opensource.org/licenses/upl
  termsOfService: https://www.oracle.com/legal/terms.html
  description: 'Operations tagged ProfileExternal across 2 of this provider''s published API definitions: oracle-hospitality-property-outbound-crmoutbound.json, oracle-hospitality-property-v1-crm.json. Each path carries the servers of the definition it was published in.'
servers:
- url: /crm/v1
tags:


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