Markets are used to categorize theatres based on geographic location.
| Verb | Endpoint | Description | |
|---|---|---|---|
| GET | /v1/markets | Get All Markets. |
page-number query string parameter to specify which page of results to retrieve.
page-size query string parameter to specify the number of results per page.
| Name | Description |
|---|---|
| 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.Markets | A list of Market Representations returned. |
| Relation | Description | Verbs | Templated |
|---|---|---|---|
| self | The current list of markets results. | GET | No |
| previous | The previous page of markets results. | GET | No |
| next | The next page of markets results. | GET | No |
| Name | Description |
|---|---|
| id | The unique identifier of a market. |
| name | Full name for display. |
| slug | The market slug. |
| Relation | Description | Methods | Templated |
|---|---|---|---|
| self | The current market representation. | GET | No |
| https://api.amctheatres.com/v2/theatres | A list of theatres in this market. | GET | No |
GET /v1/markets
{
"pageSize": 1,
"pageNumber": 1,
"count": 100,
"_embedded": {
"markets": [
{
"id": 1,
"name": "Allentown",
"slug": "allentown",
"_links": {
"self": {
"href": "https://api.amctheatres.com/v1/markets/allentown",
"templated": false
},
"https://api.amctheatres.com/v2/theatres": {
"href": "https://api.amctheatres.com/v2/theatres?market=allentown",
"templated": false
}
}
}
]
},
"_links": {
"self": {
"href": "https://api.amctheatres.com/v1/markets?pageNumber=1&pageSize=1",
"templated": false
},
"previous": {
"href": "https://api.amctheatres.com/v1/markets?pageNumber=1&pageSize=1",
"templated": false
},
"next": {
"href": "https://api.amctheatres.com/v1/markets?pageNumber=2&pageSize=1"
}
}
}