Verify the payable loyalty points of a guest

Use this API to check how many loyalty points and the loyalty amount (in $) that a guest can redeem while paying for an invoice.
You must specify appropriate details for the InvoiceId parameter. Optionally, you can provide the required values for the lp_program_id and redeem_across_programs parameters.

Response Details

NameTypeDescription
lp_redeemableobjectObject that contains the guest's redeemable loyalty points-related elements. For more information, refer to the lp_redeemable Object table.
errorobjectObject that contains the error message and error code-related details. For more information, refer to the error Object table.

lp_redeemable Object

NameTypeDescription
pointsdecimalNumber of loyalty points that the guest can use to pay for the invoice.
amountdecimalLoyalty points amount (in $) that the guest can use to pay for the invoice.
loyalty_programsobjectObject that contains the guest's loyalty programs-related elements. For more information, refer to the loyalty_programs Object table.
total_available_pointsdecimalTotal loyalty points that is available for the guest across all loyalty programs.
total_available_amountdecimalTotal loyalty points amount (in $) that is available for the guest across all loyalty programs.
exchange_ratedecimalRate of conversion of one loyalty point as a dollar amount.

loyalty_programs Object

NameTypeDescription
idguidUnique 32-character identifier of the guest's loyalty program.
namestringName of the guest's loyalty program.
pointsobjectObject that contains the guest's loyalty points-related elements for the specific loyalty program. For more information, refer to the points Object table.

points Object

NameTypeDescription
earneddecimalNumber of loyalty points that the guest has earned in the loyalty program.
redeemeddecimalNumber of loyalty points that the guest has redeemed in the loyalty program.
availabledecimalNumber of loyalty points that the guest can redeem in the loyalty program.

error Object

Error CodeError Message
502invoice_id is not valid.
502ProgramId is not valid.
Language
Authorization
Header
Click Try It! to start a request and see the response here!