Connect API - version 5.0.9.24 - 7e0560eca05bb0f97d04d090565b2aa195fd9502

Loyalty sessions

A Loyalty session represents an authenticated (e.g. logged in) Loyalty member and the actions they carry out through the Connect API.

This authentication is supplied to Connect via the loyaltySessionToken header parameter. When received by the API any endpoint which performs member-specific functionality will do so based on the member the token represents.

Member benefits

Member benefits are specific items, tickets and pricing that are available only to some/all loyalty members. These include:

  • Loyalty only tickets and earned recognition tickets, returned from GetTicketsForSession and available for purchase via the AddTickets or SetTickets endpoints
  • Earned recognition concession items, returned via GetConcessions and available for purchase via the AddConcessions endpoint
  • Earned recognition discounts and recognition promotions
  • Deals available via an earned recognition, returned in SuggestedDeals and applied automatically when order criteria is met
  • Advanced booking rules earned via loyalty recognition, available in browsing APIs and available to purchase earlier than non-members
  • Ability to redeem earned points for items in the loyalty reward store
  • Ability to submit experience and film ratings
  • Ability to view and respond to loyalty messages

Member management

Accessing and updating member data is typically locked down by security such that only calls authenticated via an appropriate loyaltySession can access a members information. This includes:

  • Accessing member information via the GetMember endpoint
  • Updating member information via the UpdateMember endpoint
  • Accessing member loyalty transaction history via the GetMemberTransactionHistory endpoint
  • Accessing a members benefits via the GetMemberItemList endpoint

Booking management

Similar to accessing member data, viewing and editing member bookings is typically locked down by security and authenticated via an appropriate loyaltySession. These actions includes:

  • Getting a booking via the GetSingleBooking endpoint
  • Retrieving past bookings via the GetBookings endpoint
  • Refunding a booking via the RefundBooking endpoint
  • Canceling an unpaid booking via the CancelBooking endpoint

Member-based payment options

Members may also have access to alternative payment options not available to non-members: