Oracle Hospitality

Oracle Hospitality Profile Membership API

This will allow you to create a guest profile enrollment in OPERA Cloud. Enrollment relates to a membership program, so as an example you can enrol the guest Mr Tom Smith into a Membership / loyalty program.

GitHub OpenAPI
Business capability
Travel Loyalty Programme Management BC-4050

Operations 45

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}/chains/{chainCode}/enrollments Enroll a guest in an external system's loyalty program · Create an Enrollment #
Ask an LLM
“How do I enroll a guest profile into a membership program run by an external loyalty system?”
“Can a chain push a new loyalty enrollment through an external system code rather than directly in OPERA?”
Tell an agent
Enroll the guest into the membership program of external system {ext_system} for chain {chain}.
Send enrollment details {enrollment} to external system {ext_system} under chain {chain}.
PUT /externalSystems/{extSystemCode}/profiles/{externalProfileId}/profileAwards Redeem an award on an external system's profile · Redeem an award #
Ask an LLM
“How do I redeem a loyalty award for a guest identified by an external system's profile ID?”
“Can an external loyalty system redeem an award held on a profile it knows by its own ID?”
Tell an agent
Redeem an award on external profile {external_profile} in external system {ext_system}.
Redeem award {award} for external system {ext_system} profile {external_profile}.
GET /externalSystems/{extSystemCode}/profiles/{externalProfileId}/memberships Get memberships for an external system's profile · Get membership information on a profile #
Ask an LLM
“What loyalty memberships does a guest have when I only know the external system's profile ID?”
“Can I filter an external profile's memberships by membership type and a date span of up to 90 days?”
Tell an agent
Show the memberships on external profile {external_profile} from external system {ext_system}.
Get the {membership_type} membership for external profile {external_profile} in system {ext_system}.
GET /airline/transactions Check status of airline membership transactions · Get airline transactions status #
Ask an LLM
“Which membership transactions has the airline partner processed so far?”
“Can I look up airline-processed transactions by batch ID or import date?”
Tell an agent
Show the airline transaction status for batch {batch_id}.
List airline-processed membership transactions imported on {import_date}.
GET /availableAwardsBasedOnType Find loyalty awards available by award type · Get Available Awards #
Ask an LLM
“Which rate, product or room upgrade awards can a member choose from?”
“Can I find awards that cost fewer than a given number of points for a stay?”
Tell an agent
Find available awards based on {award_based_on} for membership type {membership_type}.
Show rate awards at hotel {hotel} for arrival {arrival} and departure {departure}.
DELETE /awards Cancel an award granted to a member · Delete Awards #
Ask an LLM
“How do I cancel a loyalty award that was already granted to a member?”
“Can I set how many points to charge back when an award is cancelled?”
Tell an agent destructive · confirm first
Cancel award {award_number}.
Cancel award {award_number} with {cancel_points} cancellation points.
GET /awardsToGrant List awards that can be granted to a member · Get Awards to Grant #
Ask an LLM
“Which awards could I grant to this member right now?”
“Can I narrow grantable awards by the points required or the rate code?”
Tell an agent
Show the awards I can grant to membership {membership_id}.
List grantable awards requiring {points} points at hotel {hotel}.
POST /enrollments Enroll a guest profile in a membership program · Create an Enrollment #
Ask an LLM
“How do I sign an existing guest profile up for our loyalty program in OPERA?”
“Can I enroll a guest into a membership program directly without going through an external system code?”
Tell an agent
Enroll the guest into the membership program using {enrollment}.
Create a loyalty enrollment for this guest profile in OPERA.
GET /hotels/{hotelId}/memberships/{membershipId} Get a member's issued award points at one hotel · Get Membership Issued awards points #
Ask an LLM
“How many award points has a member been issued at a particular property?”
“What award points were issued per property for one membership?”
Tell an agent
Show the issued award points for membership {membership_id} at hotel {hotel}.
Get hotel {hotel} award points issued to member {membership_id}.
POST /issueOtherAwards Issue an OTHER-type award to a member · Issue an OTHER type award #
Ask an LLM
“How do I issue a gift or other non-rate award to a loyalty member?”
“Can I issue an OTHER award by membership type and card number instead of membership ID?”
Tell an agent
Issue an OTHER type award using {award_info}.
Give this member a non-rate OTHER award.
GET /memberHistory View a guest's primary membership history · Get primary membership history details of a guest #
Ask an LLM
“What changes have been made to a guest's primary membership over time?”
“Can I filter membership history by action type, user or date range?”
Tell an agent
Show the primary membership history for membership {membership_id}.
List membership history actions for {membership_id} between {from} and {to}.
GET /membershipClaims Search membership claims across all members · Get membership claims #
Ask an LLM
“Which missing-points claims are open across all members right now?”
“Can I search membership claims by status, hotel or claim date without a membership ID?”
Tell an agent
Search all membership claims with status {status}.
Find membership claims at hotel {hotel} filed between {start} and {end}.
POST /membershipClaims Create a membership claim · Create membership Claim #
Ask an LLM
“How do I file a claim for loyalty points a member says they are missing?”
“Can I open a new membership claim with instructions attached?”
Tell an agent
Create a membership claim with details {claim}.
Open a new missing-points claim for this member.
GET /membershipClaims/{claimId} Get one membership claim · Get membership claim #
Ask an LLM
“What are the details and status of a specific membership claim?”
“Can I fetch a single claim by its claim ID?”
Tell an agent
Show membership claim {claim_id}.
Get claim {claim_id} with instructions {instructions}.
PUT /membershipClaims/{claimId} Update an existing membership claim · Change membership Claim #
Ask an LLM
“How do I change the details of a membership claim that has already been filed?”
“Can I update a claim's status after reviewing it?”
Tell an agent
Update membership claim {claim_id} with {claim}.
Change the details of existing claim {claim_id}.
POST /membershipPoints/calculations Start a membership points calculation · Calculate Membership Points #
Ask an LLM
“How do I kick off the loyalty points calculation process?”
“Can I trigger points to be recalculated for stays?”
Tell an agent
Start membership points calculation with {calculation}.
Run the membership points calculation process now.
GET /membershipPointsExceptions List membership points exceptions · Get membership points exception details #
Ask an LLM
“Which stays failed to earn points and are sitting as points exceptions?”
“Can I filter points exceptions by hotel, membership level or arrival date?”
Tell an agent
List membership points exceptions with status {status}.
Show {status} points exceptions at hotel {hotel} for membership type {membership_type}.
PUT /membershipPointsExceptions Update membership points exceptions · Update membership points exceptions #
Ask an LLM
“How do I resolve or update points exceptions after reviewing them?”
“Can I change several membership points exceptions in one request?”
Tell an agent
Update membership points exceptions with {exceptions}.
Mark the reviewed points exceptions as resolved.
GET /membershipReservationActivity Get today's reservation activity for members · Get Membership Reservation Activity #
Ask an LLM
“How many loyalty members are arriving, departing or in-house today?”
“What projected room revenue comes from members at my hotels on a given date?”
Tell an agent
Show member reservation activity for hotels {hotels}.
Get {membership_type} member arrivals, departures and in-house for hotels {hotels} on {date}.
GET /membershipTransactions/{membershipTransactionId} Get a membership points transaction · Get a membership transaction #
Ask an LLM
“What are the details of one membership transaction?”
“Can I retrieve a specific loyalty transaction by its ID?”
Tell an agent
Show membership transaction {transaction_id}.
Get the full record of loyalty transaction {transaction_id}.
GET /membershipTransactions/{membershipTransactionId}/awardPoints Get award points accrued on a transaction · Fetch the Award Points Accrued for the current points transaction #
Ask an LLM
“How many award points did a points transaction earn, and under which rule?”
“What cost per point was applied to the award points on a transaction?”
Tell an agent
Show the award points accrued on transaction {transaction_id}.
List the award point rules applied to transaction {transaction_id}.
GET /membershipTransactions/{membershipTransactionId}/pointRejectionReasons See why points were not awarded on a transaction · Fetch the reason points were not awarded for a given points transaction #
Ask an LLM
“Why didn't a guest earn points for their stay?”
“Which rule rejected points on a transaction, such as membership level requirements not met?”
Tell an agent
Explain why points were rejected on transaction {transaction_id}.
List the points rejection reasons for transaction {transaction_id}.
GET /membershipTransactions/{membershipTransactionId}/rates Get the stay rates behind a points transaction · Fetch the rate details associated to current points transaction #
Ask an LLM
“Which rate code and rate amount were used for the stay on a points transaction?”
“Can I compare the PMS rate with the central rate for a loyalty transaction?”
Tell an agent
Show the rate details for points transaction {transaction_id}.
List stay dates, rate codes and market codes for transaction {transaction_id}.
GET /membershipTransactions/{membershipTransactionId}/revenue Get the stay revenue behind a points transaction · Fetch the revenue details for the stay associated with current point transaction #
Ask an LLM
“What revenue was recognized for the stay tied to a points transaction?”
“Which revenue types and PMS revenue amounts count toward a member's points?”
Tell an agent
Show the revenue details for points transaction {transaction_id}.
Break down stay revenue by type for transaction {transaction_id}.
GET /membershipTransactions/{membershipTransactionId}/tierPoints Get tier points accrued on a transaction · Fetch the Tier Points Accrued for the current points transaction #
Ask an LLM
“How many tier points toward status did a points transaction earn?”
“Which rule generated the tier points on a loyalty transaction?”
Tell an agent
Show the tier points accrued on transaction {transaction_id}.
List tier point rules applied to transaction {transaction_id}.
GET /memberships/{membershipId}/award Export a member's award for fulfillment · Export Membership Award #
Ask an LLM
“How do I export a member's award details to a fulfillment house?”
“Can I include the award number and stay dates in a fulfillment export?”
Tell an agent
Export award {award_number} for membership {membership_id} for fulfillment processing.
Produce the fulfillment house export for member {membership_id}.
GET /memberships/{membershipId}/awardExports Get a member's award export information · Get Membership Award Export Information #
Ask an LLM
“What award information was prepared for the fulfillment house for this member?”
“Can I look up previously generated award export info by award number?”
Tell an agent
Show award export information for membership {membership_id}.
Get the export info for award {award_number} on member {membership_id}.
GET /memberships/{membershipId}/awards List awards issued to a member · Get Membership Award list #
Ask an LLM
“Which awards has a loyalty member already been issued?”
“Can I filter a member's issued awards by hotel or booking number?”
Tell an agent
List the awards issued to membership {membership_id}.
Show awards issued to member {membership_id} at hotel {hotel}.
GET /memberships/{membershipId}/claims List claims filed for one membership · Get membership claims #
Ask an LLM
“What missing-points claims has a specific member filed?”
“Can I see only one member's claims that are still pending approval?”
Tell an agent
List claims for membership {membership_id}.
Show claims for member {membership_id} with status {status}.
GET /memberships/{membershipId}/pointsToExpire See a member's points about to expire · Get membership points to expire #
Ask an LLM
“How many of a member's points are about to expire, and when?”
“Which points will lapse soon for a given membership ID?”
Tell an agent
Show points to expire for membership {membership_id}.
List the expiring point balances on member {membership_id}.
PUT /memberships/{membershipId}/pointsToExpire Extend expiring member points · Extend Member Points set to Expire #
Ask an LLM
“Can I extend the expiration date on points a member is about to lose?”
“How does the grace period in months apply when extending expiring points?”
Tell an agent
Extend expiring points for membership {membership_id}.
Extend member {membership_id}'s expiring points to {expiration}.
GET /memberships/{membershipId}/promotions List a member's promotions · Fetch membership promotions of a guest #
Ask an LLM
“Which loyalty promotions is a member signed up for?”
“Can I include inactive promotions when listing a member's promotions?”
Tell an agent
List promotions for membership {membership_id}.
Show all promotions, including inactive, for member {membership_id}.
POST /memberships/{membershipId}/promotions Add a promotion to a member · Create membership promotion of a guest #
Ask an LLM
“How do I register a member for a loyalty promotion?”
“Can I attach a new promotion code to a guest's membership?”
Tell an agent
Add promotion {promotion} to membership {membership_id}.
Sign member {membership_id} up for a new promotion.
PUT /memberships/{membershipId}/promotions/{promotionCode} Change a member's existing promotion · Change membership promotion of a guest #
Ask an LLM
“How do I edit a promotion a member is already enrolled in?”
“Can I update the details of promotion code on an existing membership?”
Tell an agent
Update promotion {promotion_code} on membership {membership_id}.
Change member {membership_id}'s promotion {promotion_code} to {promotion}.
DELETE /memberships/{membershipId}/promotions/{promotionCode} Remove a promotion from a member · Delete membership promotion of a guest #
Ask an LLM
“How do I take a member out of a promotion they joined by mistake?”
“Does deleting a membership promotion just inactivate it?”
Tell an agent destructive · confirm first
Remove promotion {promotion_code} from membership {membership_id}.
Inactivate member {membership_id}'s promotion {promotion_code}.
GET /memberships/{membershipId}/transactions Summarize a member's transactions by membership ID · Get membership transactions #
Ask an LLM
“What does a member's points transaction summary look like?”
“Can I get a transaction summary using the membership ID?”
Tell an agent
Show the transaction summary for membership {membership_id}.
Summarize loyalty transactions posted to member {membership_id}.
POST /memberships/{membershipId}/transactions Post a new membership transaction · Post a membership transaction #
Ask an LLM
“How do I post a points transaction to a member's account?”
“Can I record a manual loyalty transaction for a member?”
Tell an agent
Post transaction {transaction} to membership {membership_id}.
Record a new points transaction for member {membership_id}.
GET /membershipsCard/{membershipCardNo}/membershipType/{membershipCardType}/pointsToExpire See expiring points by membership card number · Get membership points to expire #
Ask an LLM
“Which points are about to expire when I only have the guest's membership card number?”
“Can a card number lookup of expiring points return more than one membership?”
Tell an agent
Show points to expire for card {card_no} of type {card_type}.
Look up expiring points by card number {card_no} and card type {card_type}.
GET /membershipsCard/{membershipCardNo}/membershipType/{membershipCardType}/transactions Summarize member transactions by card number · Get membership transactions #
Ask an LLM
“Can I get a transaction summary using a membership card number instead of the membership ID?”
“What transactions are on the membership tied to a given card number and card type?”
Tell an agent
Show the transaction summary for card {card_no} of type {card_type}.
Summarize transactions by membership card number {card_no}, card type {card_type}.
GET /profileForEnrollment Find matching profiles before enrollment · Get Profiles for Enrollment #
Ask an LLM
“Does this guest already have a profile I should use before enrolling them in the loyalty program?”
“Can I match enrollment candidates by name, email or phone number?”
Tell an agent
Find profiles matching {given_name} {surname} for enrollment.
Search enrollment match profiles by email {email}.
PUT /profiles/{profileId}/awards/redeem Redeem an award on an OPERA profile · Redeem an award #
Ask an LLM
“How do I redeem an award that sits on a guest's OPERA profile?”
“Can I redeem a member award using the OPERA profile ID?”
Tell an agent
Redeem an award on OPERA profile {profile_id}.
Redeem award {award} for profile {profile_id}.
GET /profiles/{profileId}/membershipTransactionExceptions List a profile's membership transaction exceptions · Get membership transaction exception details #
Ask an LLM
“Which of a guest's membership transactions ended up as exceptions?”
“Can I filter a profile's transaction exceptions by hotel and date range?”
Tell an agent
Show membership transaction exceptions for profile {profile_id}.
List transaction exceptions for profile {profile_id} at hotel {hotel} from {start} to {end}.
GET /profiles/{profileId}/memberships/history View membership card history on a profile · Get membership card history information on a profile #
Ask an LLM
“What membership cards has a guest held over time?”
“Can I see the card history for a profile's memberships?”
Tell an agent
Show membership card history for profile {profile_id}.
List past membership cards issued to profile {profile_id}.
GET /profiles/{profileId}/memberships/info Get memberships on an OPERA profile · Get membership information on a profile #
Ask an LLM
“Which loyalty memberships are attached to a guest's OPERA profile?”
“Can I narrow an OPERA profile's membership details by type or hotel?”
Tell an agent
Show membership details for OPERA profile {profile_id}.
Get the {membership_type} membership on profile {profile_id}.
GET /services/profileMembership/status Check the ProfileMembership service status · Operation to check status of ProfileMembership service #
Ask an LLM
“Is the profile membership service up and responding?”
“How can I health-check the loyalty membership service?”
Tell an agent
Ping the profile membership service.
Check whether the membership service is available for hotel {hotel}.

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-profilemembership-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-profilemembership-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-profilemembership-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Oracle Hospitality Profile Membership 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 ProfileMembership 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 (548 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/openapi/oracle-hospitality-profilemembership-api-openapi.yml