Loyalty Cards

V4

The Loyalty Card endpoints provide access to loyalty card balance information.


Endpoints

Verb Endpoint Description
GET /v4/loyalty-cards/{card-number} Get Loyalty Card.
GET /v4/loyalty-cards?loyalty-account-id={loyalty-account-id}&email={email} Get Loyalty Card.

Loyalty Cards Query Parameters

  • You may optionally supply a loyalty-account-id query string parameter to the Loyalty account id of the Loyalty account for returned card.
  • You may optionally supply a email query string parameter to the email of the Loyalty account for returned card.

Loyalty Account


Loyalty Account Properties

Name Description
profileId The AMC Profile Id associated with this loyalty card.
cardNumber Loyalty Card Number.
balance The current loyalty card balance as a decimal in USD.
pointsEarned The current loyalty card balance as rewards points.
accountType The current loyalty card account type.
  • WebOnly
  • Legacy
  • Insider
  • Premiere
  • Associate
status The current loyalty card status.
  • Active
  • Inactive
  • Closed
statusInfo The current loyalty card sub-status
  • Active
  • Not Activated
  • Closed
  • Fraud
  • Lost/Stolen
  • Expired
  • Expiring
  • Cancelled
  • Suspended
ActivationDate The activation date of the loyalty card.
expirationDate Expiration date of the loyalty account


Loyalty Account Links

Relation Description Methods Templated
self This loyalty card GET No

LoyaltyEarnProduct


LoyaltyEarnProduct Properties

Name Description
productId The product id number.
description The product description.
ticketType The type of ticket associated with the earn product.
featureName The name of the movie.
featureId The movie id number.
auditoriumName The name of the auditorium.
price The price of the product.
discountedPrice The discounted price of the product.
categoryName The category of the product.
subCategoryName The sub category of the product.


Examples

Get the loyalty card 1234567891234567
GET  /v4/loyalty-cards/1234567891234567

Response

{
  "profileId": 123,
  "cardNumber": 1102050000000001,
  "balance": 0,
  "pointsEarned": 0,
  "accountType": "Premiere",
  "status": "Active",
  "statusInfo": "Active",
  "activationDate": "2017-06-20T00:00:00",
  "expirationDate": "2018-06-20T00:00:00",
  "_links": {
    "self": {
      "href": "https://api.amctheatres.com/v4/loyalty-cards/1234567891234567",
      "templated": false
    },
    "subscription": {
      "href": "https://api.amctheatres.com/v2/loyalty-cards/1234567891234567/product-subscriptions",
      "templated": false
    },
    "https://api.amctheatres.com/rels/v2/loyalty-cards/product-subscriptions/alist": {
      "href": "https://api.amctheatres.com/v2/loyalty-cards/1234567891234567/product-subscriptions/alist",
      "templated": false
    }
  }
}
Get the loyalty card associated with the given email address.
GET  /v4/[email protected]

Response

{
  "profileId": 123,
  "cardNumber": 1102050000000001,
  "balance": 0,
  "pointsEarned": 0,
  "accountType": "Premiere",
  "status": "Active",
  "statusInfo": "Active",
  "activationDate": "2017-06-20T00:00:00",
  "expirationDate": "2018-06-20T00:00:00",
  "_links": {
    "self": {
      "href": "https://api.amctheatres.com/v4/loyalty-cards/1234567891234567",
      "templated": false
    },
    "subscription": {
      "href": "https://api.amctheatres.com/v2/loyalty-cards/1234567891234567/product-subscriptions",
      "templated": false
    },
    "https://api.amctheatres.com/rels/v2/loyalty-cards/product-subscriptions/alist": {
      "href": "https://api.amctheatres.com/v2/loyalty-cards/1234567891234567/product-subscriptions/alist",
      "templated": false
    }
  }
}
Get the loyalty card with the given Loyalty account id.
GET  /v4/loyalty-cards?loyalty-account-id=123456789012345

Response

{
  "profileId": 123,
  "cardNumber": 1102050000000001,
  "balance": 0,
  "pointsEarned": 0,
  "accountType": "Premiere",
  "status": "Active",
  "statusInfo": "Active",
  "activationDate": "2017-06-20T00:00:00",
  "expirationDate": "2018-06-20T00:00:00",
  "_links": {
    "self": {
      "href": "https://api.amctheatres.com/v4/loyalty-cards/1234567891234567",
      "templated": false
    },
    "subscription": {
      "href": "https://api.amctheatres.com/v2/loyalty-cards/1234567891234567/product-subscriptions",
      "templated": false
    },
    "https://api.amctheatres.com/rels/v2/loyalty-cards/product-subscriptions/alist": {
      "href": "https://api.amctheatres.com/v2/loyalty-cards/1234567891234567/product-subscriptions/alist",
      "templated": false
    }
  }
}