In this guide we will run through a basic process for finding a showtime at a theatre, and creating an order featuring two Reserved Seating (RS) tickets for that showtime.
Request showtimes for a theatre and date.
Note that showtime ticket prices are not final and are for display only.
Note the https://api.amctheatres.com/rels/v3/seating-layout link on the showtime resource.
GET /v2/theatres/610/showtimes/10-22-2014?page-size=1
{
"pageSize": 1,
"pageNumber": 10,
"count": 33,
"_links": {
"self": {
"href": "https://api.amctheatres.com/v2/theatres/610/showtimes/05-30-2014?page-number=1&page-size=1",
"templated": false
},
"next": {
"href": "https://api.amctheatres.com/v2/theatres/610/showtimes/05-30-2014?page-number=2&page-size=1",
"templated": false
}
},
"_embedded": {
"showtimes": [
{
"id": 26250458,
"performanceNumber": 97027,
"sortableTitleName": "Mortal Instruments",
"showDateTimeUtc": "2014-05-30T19:00:00Z",
"showDateTimeLocal": "2014-05-30T14:00:00",
"isSoldOut": false,
"isCanceled": false,
"auditorium": 7,
"runTime": 90,
"mpaaRating": "PG13",
"purchaseUrl": "https://amctheatres.com/order/towncenter/05-30-2014/97027",
"mobilePurchaseUrl": "https://amctheatres.com/order/towncenter/05-30-2014/97027",
"attributes": [
{
"name": "RealD 3D",
"description": "Forget the days of red-and-green glasses and eyestrain - feast your eyes on the mind-blowing RealD
3D experience at AMC. Using a new digital approach, you can watch movies like they’ve never been seen before with amazing depth
and clarity without sacrificing comfort. Experience your favorite films in a new dimension at AMC"
}
],
"ticketPrices": [
{
"price": 7.50,
"type": "ADULT",
"sku": "TICKET-RS-26250946-ADULT",
"tax": 0.60
}
],
"media": {
},
"_links": {
"self": {
"href": "https://api.amctheatres.com/v2/showtimes/26250458",
"templated": false
},
"https://api.amctheatres.com/rels/v2/movie": {
"href": "https://api.amctheatres.com/v2/movies/41653",
"templated": false
},
"https://api.amctheatres.com/rels/v2/theatre": {
"href": "https://api.amctheatres.com/v2/theatres/610",
"templated": false
},
"https://api.amctheatres.com/rels/v3/seating-layout": {
"href": "https://api.amctheatres.com/v3/seating-layouts/610/97027",
"templated": false
}
}
}
]
}
}
Request the seating layout via the https://api.amctheatres.com/rels/v3/seating-layout link href.
Note that seats of type "CanReserve" and available being true are open seats which can be reserved.
Note the row and column of the seats you would like to reserve,.
GET /v3/seating-layouts/610/97027
{
"theatreNumber": 610,
"performanceNumber": 97027,
"rows": 7,
"columns": 16,
"seats": [
{
"available": true,
"row": 1,
"seatName": "",
"column": 1,
"type": "CanReserve"
},
{
"available": true,
"row": 1,
"seatName": "",
"column": 2,
"type": "CanReserve"
},
{
"available": true,
"row": 1,
"seatName": "",
"column": 3,
"type": "CanReserve"
},
{
"available": true,
"row": 1,
"seatName": "",
"column": 4,
"type": "CanReserve"
},
{
"available": true,
"row": 1,
"seatName": "",
"column": 5,
"type": "CanReserve"
},
{
"available": true,
"row": 1,
"seatName": "",
"column": 6,
"type": "CanReserve"
},
{
"available": true,
"row": 1,
"seatName": "",
"column": 7,
"type": "CanReserve"
},
{
"available": true,
"row": 1,
"seatName": "",
"column": 8,
"type": "CanReserve"
},
{
"available": true,
"row": 1,
"seatName": "",
"column": 9,
"type": "CanReserve"
},
{
"available": true,
"row": 1,
"seatName": "",
"column": 10,
"type": "CanReserve"
},
{
"available": true,
"row": 1,
"seatName": "",
"column": 11,
"type": "NotASeat"
}
],
"_links": {
"self": {
"href": "https://api.amctheatres.com/v3/seating-layout/610/97027",
"templated": false
}
}
}
Request creation of an order featuring tickets for the showtime.
Note the Order ID in Location header value in the response as you will use this ID to work with the created order.
POST /v3/orders
{
"email": "[email protected]",
"products": [
{
"sku": "TICKET-RS-26250946-ADULT",
"quantity": 1,
"row": 1,
"column": 1
},
{
"sku": "TICKET-RS-26250946-ADULT",
"quantity": 1,
"row": 1,
"column": 2
}
]
}
HTTP/1.1 201 Created
Location: https://api.amctheatres.com/v3/orders/98096