Products

V3

Returns product information


Endpoints

Verb Endpoint Description
GET /v3/products/{sku} Returns the product associated with the given sku
GET /v3/products/{sku}/theatres/{theatre-id} Returns a list of products associated with the given sku and theatre

Products Query Parameters

  • You may optionally supply a includeinactives query string parameter to returns all product subscriptions.

Products Properties

Name Description
sku Represents a unique identifier for each distinct product for purchase. Skus are constructed manually using variables that define the product, to learn more about building skus please visit our "SKU Building" Page.
cost The unit cost of the product as a decimal.
previousCost The previous unit cost of the product as a decimal. Nullable.
tax The unit tax of the product as a decimal.
theatreId Theatre number associated with product.
minimumAge The required minimum age needed to purchase this product.
name The name of the product.
description A description of the product (A-List only).
planTypeDescription Description of the plan type. This is the state exclusion list text.
durationMonths The duration of the voucher product in months (Voucher products only).
attributes A list of attributes associated with the product (A-List only).
  • code: Product attribute code.
  • name: Product attribute name.
  • description: Product attribute description.
  • value: Product attribute value.
  • valueDescription: Product attribute value description.

Products Links

Relation Description Verbs Templated
self The current product representation. GET No

Examples

Returns the product associated with the given sku
GET  v3/products/loyalty-new

Response

{
  "sku": "LOYALTY-NEW",
  "cost": 12.5,
  "previousCost": 15.0,
  "minimumAge": 13,
  "_links": {
    "self": {
      "href": "https://api.amctheatres.com/v3/products/loyalty-new",
      "templated": false
    }
  }
}
Returns the product associated with the given sku with additional query string information
GET  v3/products/loyalty-new?theatre-id=38

Response

{
  "sku": "LOYALTY-NEW",
  "cost": 12.5,
  "theatreId": 38,
  "tax": 1.25,
  "minimumAge": 13,
  "_links": {
    "self": {
      "href": "https://api.amctheatres.com/v3/products/loyalty-new?theatre-id=38",
      "templated": false
    }
  }
}