Concessions Categories

V1

Concessions categories for a theatre.


Endpoints

Verb Endpoint Description
GET /v1/theatres/{theatre-id}/concessions/categories Get all concessions categories for a theatre.

Concessions Categories Query Parameters

  • You may optionally supply a page-number query string parameter to specify which page of results to retrieve.
    • If one isn't provided the results will begin with the first page (a value of 1 will be used).
  • You may optionally supply a page-size query string parameter to specify the number of results per page.
    • If one isn't provided a default of 10 will be used.

Concessions Categories Properties

Name Description
theatreId The theatre id.
pageSize The number of results included for each page, up to a maximum of 100. Defaults to 10.
pageNumber The page number returned.
count The total number of results available across all pages.
_embedded.ConcessionsCategories A list of Concessions Category Representations returned.

Concessions Categories Links

Relation Description Verbs Templated
self The current list of ConcessionsCategories results. GET No
previous The previous page of ConcessionsCategories results. GET No
next The next page of ConcessionsCategories results. GET No

Concessions Category


Concessions Category Properties

Name Description
name Concessions category name.
level Category hierarchy level.
sortOrder Category sort order within level.
categoryId The Category Id.


Concessions Category Links

Relation Description Methods Templated
https://api.amctheatres.com/rels/v1/concessions All concessions belonging to the category. GET Yes
https://api.amctheatres.com/rels/v2/media The concession category's associated media (video, images, etc.) GET Yes

Examples

Get Concessions Categories.
GET  https://api.amctheatres.com/v1/theatres/610/concessions/categories

Response

{
  "theatreId": 610,
  "pageSize": 7,
  "pageNumber": 2,
  "count": 15,
  "_embedded": {
    "concessionsCategories": [
      {
        "name": "Beverages",
        "level": 1,
        "sortOrder": 3,
        "categoryId": 3,
        "_links": {
          "https://api.amctheatres.com/v1/rels/concessions": {
            "href": "https://api.amctheatres.com/v1/theatres/610/concessions?category=beverages",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/media": {
            "href": "https://api.amctheatres.com/v2/media/product-categories/3/{media-type}",
            "templated": true
          }
        }
      },
      {
        "name": "Combos",
        "level": 1,
        "sortOrder": 1,
        "categoryId": 7,
        "_links": {
          "https://api.amctheatres.com/v1/rels/concessions": {
            "href": "https://api.amctheatres.com/v1/theatres/610/concessions?category=combos",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/media": {
            "href": "https://api.amctheatres.com/v2/media/product-categories/7/{media-type}",
            "templated": true
          }
        }
      },
      {
        "name": "Hot Foods",
        "level": 1,
        "sortOrder": 5,
        "categoryId": 8,
        "_links": {
          "https://api.amctheatres.com/v1/rels/concessions": {
            "href": "https://api.amctheatres.com/v1/theatres/610/concessions?category=hot+foods",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/media": {
            "href": "https://api.amctheatres.com/v2/media/product-categories/8/{media-type}",
            "templated": true
          }
        }
      },
      {
        "name": "Meals",
        "level": 1,
        "sortOrder": 4,
        "categoryId": 9,
        "_links": {
          "https://api.amctheatres.com/v1/rels/concessions": {
            "href": "https://api.amctheatres.com/v1/theatres/610/concessions?category=meals",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/media": {
            "href": "https://api.amctheatres.com/v2/media/product-categories/9/{media-type}",
            "templated": true
          }
        }
      },
      {
        "name": "Popcorn",
        "level": 1,
        "sortOrder": 2,
        "categoryId": 2,
        "_links": {
          "https://api.amctheatres.com/v1/rels/concessions": {
            "href": "https://api.amctheatres.com/v1/theatres/610/concessions?category=popcorn",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/media": {
            "href": "https://api.amctheatres.com/v2/media/product-categories/2/{media-type}",
            "templated": true
          }
        }
      },
      {
        "name": "Snacks",
        "level": 1,
        "sortOrder": 6,
        "categoryId": 10,
        "_links": {
          "https://api.amctheatres.com/v1/rels/concessions": {
            "href": "https://api.amctheatres.com/v1/theatres/610/concessions?category=snacks",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/media": {
            "href": "https://api.amctheatres.com/v2/media/product-categories/10/{media-type}",
            "templated": true
          }
        }
      },
      {
        "name": "Treats",
        "level": 1,
        "sortOrder": 0,
        "categoryId": 6,
        "_links": {
          "https://api.amctheatres.com/v1/rels/concessions": {
            "href": "https://api.amctheatres.com/v1/theatres/610/concessions?category=treats",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/media": {
            "href": "https://api.amctheatres.com/v2/media/product-categories/6/{media-type}",
            "templated": true
          }
        }
      }
    ]
  },
  "_links": {
    "self": {
      "href": "https://api.amctheatres.com/v1/theatres/610/concessions/categories?pageNumber=2&pageSize=7",
      "templated": false
    },
    "previous": {
      "href": "https://api.amctheatres.com/v1/theatres/610/concessions/categories?pageNumber=1&pageSize=7",
      "templated": false
    },
    "next": {
      "href": "https://api.amctheatres.com/v1/theatres/610/concessions/categories?pageNumber=3&pageSize=7"
    }
  }
}