Embargoed Showtimes

V2

The Embargoed showtimes endpoints allow retrieval of AMC Theatres showtime information where future dated online tickets are available for purchase.

Endpoints

Verb Endpoint Description
GET /v2/theatres/{theatre-number}/showtimes/{date}/views/embargoed Returns all embargoed showtimes for the specified Theatre and Date and meeting additional search criteria provided.

Embargoed Showtimes Properties

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.
lastUpdatedDateUtc The date time UTC of when any showtime in the result set was last updated.
_embedded.Showtimes A list of Showtime Representations returned.

Embargoed Showtimes Links

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

Showtime


Showtime Properties

Name Description
id The showtime id.
performanceNumber The Radiant performance number.
movieId The movie id.
movieName The movie title.
genre The primary genre of the movie.
movieUrl The movie website URL.
sortableMovieName The movie's sortable title name.
showDateTimeUtc The show date/time in UTC (ISO-8601)
showDateTimeLocal The show date/time in the theatre's local timezone.
sellUntilDateTimeUtc The date time UTC of when the showtime should stop being sold.
auditorium The auditorium id where the showing is taking place.
layoutId The auditorium layout being used for the this showtime.
layoutVersionNumber The auditorium layout version number. This is incremented whenever an auditorium layout is modified.
isSoldOut Indicates if tickets are sold out.
isAlmostSoldOut Indicates if tickets are almost sold out based on an AMC predefined threshold.
isCanceled Indicates if the showing has been canceled.
utcOffset The UTC offset of the showtime.
purchaseUrl The website url where tickets may be purchased from AMC Theatres.
mobilePurchaseUrl The mobile website url where tickets may be purchased from AMC Theatres.
runTime The duration of the showing in minutes.
mpaaRating The MPAA's (Motion Picture Association of America's) official movie rating.
permiumFormat The premium format of the showtime.
ticketPrices The showings ticket prices.
lastUpdatedDateUtc The date time UTC of when the showtime was last updated.
media.heroDesktopDynamic Url location of hero Desktop.
media.heroMobileDynamic Url location of hero Mobile.
media.posterDynamic Url location of the Movie Poster.
media.posterAlternateDynamic Url location of the Movie poster alternate.
media.poster3DDynamic Url location of the Movie 3D poster.
media.posterIMAXDynamic Url location of the IMAX poster.
media.trailerTeaserDynamic Url location of the trailer teaser.
media.trailerAlternateDynamic Url location of the alternate trailer.
isEmbargoed Nullable flag indicating if this showtime is embargoed. If false or null, showtime is not embargoed.
isComingSoon Nullable flag indicating if this showtime is coming soon (will be available for display soon). If false or null, showtime is not coming soon.
isDiscountMatineePriced Indicates whether this showtime is available at a discounted matinee price.
discountMatineeMessage If a showtime is available at discounted matinee price, display message for PLF and Non PLF showtimes.
visibilityDateTimeUtc A UTC DateTime indicating when an embargoed showtime will become displayable, and no longer be embargoed.
maximumIntendedAttendance The maximum allowed intended attendance for this Private Theatre Rental.
attributes A list of showtime attributes.
_embedded.TicketPrices A list of TicketPrice Representations returned.


Showtime Links

Relation Description Methods Templated
self The current showtime representation. GET No
https://api.amctheatres.com/rels/v2/movie The movie being shown. GET No
https://api.amctheatres.com/rels/v2/theatre The theatre where the showing occurs. GET No
https://api.amctheatres.com/rels/v2/seating-layout The auditorium's seating layout (if showing is reserved seating). GET No
https://api.amctheatres.com/rels/v2/showtimes/private-theatre-rental-movies The available movies for the current showtime if it is a private theatre rental. GET No

Ticket Price


Ticket Price Properties

Name Description
price A decimal value representing the price of the ticket in USD. The value is not final and is for display only
type The ticket type, adult, child, or senior
sku The SKU value used to assemble the product for an order
agePolicy The age based policy regarding sale of the particular ticket type
tax A decimal value representing the tax on the ticket price in USD. The value is not final and is for display only.

Attribute


Attribute Properties

Name Description
name The display name
description The attribute description.
code The unique identifier for queries.


Examples

Get theatre embargoed showtimes for a movie
GET  v2/theatres/610/showtimes/9-21-2017/views/embargoed

Response

{
  "pageSize": 10,
  "pageNumber": 1,
  "count": 4,
  "lastUpdatedDateUtc": "2017-08-08T23:59:18Z",
  "_links": {
    "self": {
      "href": "https://api.amctheatres.com/v2/theatres/610/showtimes/9-21-2017/views/embargoed?page-number=1&page-size=10",
      "templated": false
    }
  },
  "_embedded": {
    "showtimes": [
      {
        "id": 58408301,
        "internalReleaseNumber": 59515,
        "performanceNumber": 13039,
        "movieId": 51251,
        "movieName": "Atomic Blonde",
        "sortableMovieName": "Atomic Blonde",
        "genre": "ACTION",
        "showDateTimeUtc": "2017-09-21T21:05:00Z",
        "showDateTimeLocal": "2017-09-21T16:05:00",
        "sellUntilDateTimeUtc": "2017-09-21T21:15:00Z",
        "isSoldOut": false,
        "isAlmostSoldOut": false,
        "isCanceled": false,
        "utcOffset": "-05:00",
        "theatreId": 610,
        "auditorium": 6,
        "layoutId": 19,
        "layoutVersionNumber": 1,
        "runTime": 114,
        "mpaaRating": "R",
        "premiumFormat": "",
        "purchaseUrl": "https://api.amctheatres.com/showtimes/all/2017-09-21/studio/all/58408301",
        "mobilePurchaseUrl": "https://api.amctheatres.com/showtimes/all/2017-09-21/studio/all/58408301",
        "movieUrl": "https://api.amctheatres.com/movies/atomic-blonde-51251",
        "wwmReleaseNumber": 234132,
        "lastUpdatedDateUtc": "2017-08-08T23:59:18Z",
        "embargoed": true,
        "attributes": [
          {
            "code": "SPECIALENGAGEMENTS",
            "name": "Special Engagements",
            "description": "Some types of passes may be restricted for Special Engagements or New Releases and thus subject to a surcharge. Be sure to read the back of your pass for more details."
          },
          {
            "code": "RESERVEDSEATING",
            "name": "Reserved Seating",
            "description": "Select your seat when you buy your tickets online, on our mobile app or at the theatre."
          },
          {
            "code": "AMCINDEPENDENT",
            "name": "AMC independent",
            "description": "AMC independent identifies a Title sourced outside of normal distribution channels."
          },
          {
            "code": "DESCRIPTIVEVIDEO",
            "name": "Audio Description",
            "description": "Audio Description."
          },
          {
            "code": "CLOSEDCAPTION",
            "name": "Closed Caption",
            "description": "Closed Caption"
          },
          {
            "code": "DINEINSEATSIDESERVICE",
            "name": "Dine-In Full Service",
            "description": "The perfect way to experience dinner and a movie.  Reserve your seat and enjoy a made-from-scratch menu prepared fresh by our chefs, plus a full bar.  Just push the service button at your seat to order."
          }
        ],
        "ticketPrices": [
          {
            "price": 9.84,
            "type": "ADULT",
            "sku": "TICKET-RS-58408301-ADULT",
            "tax": 0.85
          },
          {
            "price": 6.56,
            "type": "CHILD",
            "sku": "TICKET-RS-58408301-CHILD",
            "agePolicy": "Age 2-12",
            "tax": 0.57
          },
          {
            "price": 8.2,
            "type": "SENIOR",
            "sku": "TICKET-RS-58408301-SENIOR",
            "agePolicy": "Age 60+",
            "tax": 0.71
          }
        ],
        "media": {
          "posterThumbnail": "",
          "posterStandard": "",
          "posterLarge": "",
          "heroDesktopDynamic": "https://cdn.amctheatres.com/production/2/movies/51300/51251/HeroDesktopDynamic/32722.jpg",
          "heroMobileDynamic": "",
          "posterDynamic": "https://cdn.amctheatres.com/production/2/movies/51300/51251/Poster/234132R1.JPG",
          "posterAlternateDynamic": "",
          "poster3DDynamic": "",
          "posterIMAXDynamic": "",
          "trailerTeaserDynamic": "",
          "trailerAlternateDynamic": ""
        },
        "languages": {
          "spoken": "English"
        },
        "_links": {
          "self": {
            "href": "https://api.amctheatres.com/v2/showtimes/58408301",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/movie": {
            "href": "https://api.amctheatres.com/v2/movies/51251",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/theatre": {
            "href": "https://api.amctheatres.com/v2/theatres/610",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v1/seating-layout": {
            "href": "https://api.amctheatres.com/v1/seating-layouts/610/13039",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/seating-layout": {
            "href": "https://api.amctheatres.com/v2/seating-layouts/610/13039",
            "templated": false
          }
        }
      },
      {
        "id": 58408418,
        "internalReleaseNumber": 59515,
        "performanceNumber": 13087,
        "movieId": 51251,
        "movieName": "Atomic Blonde",
        "sortableMovieName": "Atomic Blonde",
        "genre": "ACTION",
        "showDateTimeUtc": "2017-09-21T21:05:00Z",
        "showDateTimeLocal": "2017-09-21T16:05:00",
        "sellUntilDateTimeUtc": "2017-09-21T21:15:00Z",
        "isSoldOut": false,
        "isAlmostSoldOut": false,
        "isCanceled": false,
        "utcOffset": "-05:00",
        "theatreId": 610,
        "auditorium": 22,
        "layoutId": 20,
        "layoutVersionNumber": 1,
        "runTime": 114,
        "mpaaRating": "R",
        "premiumFormat": "",
        "purchaseUrl": "https://api.amctheatres.com/showtimes/all/2017-09-21/studio/all/58408418",
        "mobilePurchaseUrl": "https://api.amctheatres.com/showtimes/all/2017-09-21/studio/all/58408418",
        "movieUrl": "https://api.amctheatres.com/movies/atomic-blonde-51251",
        "wwmReleaseNumber": 234132,
        "lastUpdatedDateUtc": "2017-08-08T23:59:18Z",
        "embargoed": true,
        "attributes": [
          {
            "code": "SPECIALENGAGEMENTS",
            "name": "Special Engagements",
            "description": "Some types of passes may be restricted for Special Engagements or New Releases and thus subject to a surcharge. Be sure to read the back of your pass for more details."
          },
          {
            "code": "RESERVEDSEATING",
            "name": "Reserved Seating",
            "description": "Select your seat when you buy your tickets online, on our mobile app or at the theatre."
          },
          {
            "code": "AMCINDEPENDENT",
            "name": "AMC independent",
            "description": "AMC independent identifies a Title sourced outside of normal distribution channels."
          },
          {
            "code": "DESCRIPTIVEVIDEO",
            "name": "Audio Description",
            "description": "Audio Description."
          },
          {
            "code": "CLOSEDCAPTION",
            "name": "Closed Caption",
            "description": "Closed Caption"
          }
        ],
        "ticketPrices": [
          {
            "price": 8.2,
            "type": "ADULT",
            "sku": "TICKET-RS-58408418-ADULT",
            "tax": 0.71
          },
          {
            "price": 6.56,
            "type": "CHILD",
            "sku": "TICKET-RS-58408418-CHILD",
            "agePolicy": "Age 2-12",
            "tax": 0.57
          },
          {
            "price": 6.56,
            "type": "SENIOR",
            "sku": "TICKET-RS-58408418-SENIOR",
            "agePolicy": "Age 60+",
            "tax": 0.57
          }
        ],
        "media": {
          "posterThumbnail": "",
          "posterStandard": "",
          "posterLarge": "",
          "heroDesktopDynamic": "https://cdn.amctheatres.com/production/2/movies/51300/51251/HeroDesktopDynamic/32722.jpg",
          "heroMobileDynamic": "",
          "posterDynamic": "https://cdn.amctheatres.com/production/2/movies/51300/51251/Poster/234132R1.JPG",
          "posterAlternateDynamic": "",
          "poster3DDynamic": "",
          "posterIMAXDynamic": "",
          "trailerTeaserDynamic": "",
          "trailerAlternateDynamic": ""
        },
        "languages": {
          "spoken": "English"
        },
        "_links": {
          "self": {
            "href": "https://api.amctheatres.com/v2/showtimes/58408418",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/movie": {
            "href": "https://api.amctheatres.com/v2/movies/51251",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/theatre": {
            "href": "https://api.amctheatres.com/v2/theatres/610",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v1/seating-layout": {
            "href": "https://api.amctheatres.com/v1/seating-layouts/610/13087",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/seating-layout": {
            "href": "https://api.amctheatres.com/v2/seating-layouts/610/13087",
            "templated": false
          }
        }
      },
      {
        "id": 58408458,
        "internalReleaseNumber": 59515,
        "performanceNumber": 13097,
        "movieId": 51251,
        "movieName": "Atomic Blonde",
        "sortableMovieName": "Atomic Blonde",
        "genre": "ACTION",
        "showDateTimeUtc": "2017-09-21T21:05:00Z",
        "showDateTimeLocal": "2017-09-21T16:05:00",
        "sellUntilDateTimeUtc": "2017-09-21T21:15:00Z",
        "isSoldOut": false,
        "isAlmostSoldOut": false,
        "isCanceled": false,
        "utcOffset": "-05:00",
        "theatreId": 610,
        "auditorium": 27,
        "layoutId": 21,
        "layoutVersionNumber": 1,
        "runTime": 114,
        "mpaaRating": "R",
        "premiumFormat": "",
        "purchaseUrl": "https://api.amctheatres.com/showtimes/all/2017-09-21/studio/all/58408458",
        "mobilePurchaseUrl": "https://api.amctheatres.com/showtimes/all/2017-09-21/studio/all/58408458",
        "movieUrl": "https://api.amctheatres.com/movies/atomic-blonde-51251",
        "wwmReleaseNumber": 234132,
        "lastUpdatedDateUtc": "2017-08-08T23:59:18Z",
        "embargoed": true,
        "attributes": [
          {
            "code": "SPECIALENGAGEMENTS",
            "name": "Special Engagements",
            "description": "Some types of passes may be restricted for Special Engagements or New Releases and thus subject to a surcharge. Be sure to read the back of your pass for more details."
          },
          {
            "code": "RESERVEDSEATING",
            "name": "Reserved Seating",
            "description": "Select your seat when you buy your tickets online, on our mobile app or at the theatre."
          },
          {
            "code": "AMCINDEPENDENT",
            "name": "AMC independent",
            "description": "AMC independent identifies a Title sourced outside of normal distribution channels."
          },
          {
            "code": "DESCRIPTIVEVIDEO",
            "name": "Audio Description",
            "description": "Audio Description."
          },
          {
            "code": "CLOSEDCAPTION",
            "name": "Closed Caption",
            "description": "Closed Caption"
          }
        ],
        "ticketPrices": [
          {
            "price": 8.2,
            "type": "ADULT",
            "sku": "TICKET-RS-58408458-ADULT",
            "tax": 0.71
          },
          {
            "price": 6.56,
            "type": "CHILD",
            "sku": "TICKET-RS-58408458-CHILD",
            "agePolicy": "Age 2-12",
            "tax": 0.57
          },
          {
            "price": 6.56,
            "type": "SENIOR",
            "sku": "TICKET-RS-58408458-SENIOR",
            "agePolicy": "Age 60+",
            "tax": 0.57
          }
        ],
        "media": {
          "posterThumbnail": "",
          "posterStandard": "",
          "posterLarge": "",
          "heroDesktopDynamic": "https://cdn.amctheatres.com/production/2/movies/51300/51251/HeroDesktopDynamic/32722.jpg",
          "heroMobileDynamic": "",
          "posterDynamic": "https://cdn.amctheatres.com/production/2/movies/51300/51251/Poster/234132R1.JPG",
          "posterAlternateDynamic": "",
          "poster3DDynamic": "",
          "posterIMAXDynamic": "",
          "trailerTeaserDynamic": "",
          "trailerAlternateDynamic": ""
        },
        "languages": {
          "spoken": "English"
        },
        "_links": {
          "self": {
            "href": "https://api.amctheatres.com/v2/showtimes/58408458",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/movie": {
            "href": "https://api.amctheatres.com/v2/movies/51251",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/theatre": {
            "href": "https://api.amctheatres.com/v2/theatres/610",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v1/seating-layout": {
            "href": "https://api.amctheatres.com/v1/seating-layouts/610/13097",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/seating-layout": {
            "href": "https://api.amctheatres.com/v2/seating-layouts/610/13097",
            "templated": false
          }
        }
      },
      {
        "id": 58408484,
        "internalReleaseNumber": 57377,
        "performanceNumber": 13103,
        "movieId": 45837,
        "movieName": "Guardians Of The Galaxy Vol. 2",
        "sortableMovieName": "Guardians Of The Galaxy Vol. 2",
        "genre": "ACTION",
        "showDateTimeUtc": "2017-09-21T21:05:00Z",
        "showDateTimeLocal": "2017-09-21T16:05:00",
        "sellUntilDateTimeUtc": "2017-09-21T21:15:00Z",
        "isSoldOut": false,
        "isAlmostSoldOut": false,
        "isCanceled": false,
        "utcOffset": "-05:00",
        "theatreId": 610,
        "auditorium": 30,
        "layoutId": 22,
        "layoutVersionNumber": 1,
        "runTime": 136,
        "mpaaRating": "PG13",
        "premiumFormat": "",
        "purchaseUrl": "https://api.amctheatres.com/showtimes/all/2017-09-21/studio/all/58408484",
        "mobilePurchaseUrl": "https://api.amctheatres.com/showtimes/all/2017-09-21/studio/all/58408484",
        "movieUrl": "https://api.amctheatres.com/movies/guardians-of-the-galaxy-vol-2-45837",
        "wwmReleaseNumber": 191861,
        "lastUpdatedDateUtc": "2017-08-08T23:59:18Z",
        "embargoed": true,
        "attributes": [
          {
            "code": "RESERVEDSEATING",
            "name": "Reserved Seating",
            "description": "Select your seat when you buy your tickets online, on our mobile app or at the theatre."
          },
          {
            "code": "NOGREENRED",
            "name": "No Green or Red Tickets",
            "description": "No green or red tickets accepted for feature presentation."
          },
          {
            "code": "DESCRIPTIVEVIDEO",
            "name": "Audio Description",
            "description": "Audio Description."
          },
          {
            "code": "CLOSEDCAPTION",
            "name": "Closed Caption",
            "description": "Closed Caption"
          }
        ],
        "ticketPrices": [
          {
            "price": 8.2,
            "type": "ADULT",
            "sku": "TICKET-RS-58408484-ADULT",
            "tax": 0.71
          },
          {
            "price": 6.56,
            "type": "CHILD",
            "sku": "TICKET-RS-58408484-CHILD",
            "agePolicy": "Age 2-12",
            "tax": 0.57
          },
          {
            "price": 6.56,
            "type": "SENIOR",
            "sku": "TICKET-RS-58408484-SENIOR",
            "agePolicy": "Age 60+",
            "tax": 0.57
          }
        ],
        "media": {
          "posterThumbnail": "https://cdn.amctheatres.com/titles/images/Poster/Thumb/3354_guardians-of-the-galaxy-2_679D.jpg",
          "posterStandard": "https://cdn.amctheatres.com/titles/images/Poster/Standard/3354_guardians-of-the-galaxy-2_562B.jpg",
          "posterLarge": "",
          "heroDesktopDynamic": "https://cdn.amctheatres.com/production/2/movies/45800/45837/MovieStills/28276.jpg",
          "heroMobileDynamic": "",
          "posterDynamic": "https://cdn.amctheatres.com/production/2/movies/45800/45837/Poster/208429R1.JPG",
          "posterAlternateDynamic": "",
          "poster3DDynamic": "",
          "posterIMAXDynamic": "",
          "trailerTeaserDynamic": "",
          "trailerAlternateDynamic": ""
        },
        "languages": {
          "spoken": "English"
        },
        "_links": {
          "self": {
            "href": "https://api.amctheatres.com/v2/showtimes/58408484",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/movie": {
            "href": "https://api.amctheatres.com/v2/movies/45837",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/theatre": {
            "href": "https://api.amctheatres.com/v2/theatres/610",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v1/seating-layout": {
            "href": "https://api.amctheatres.com/v1/seating-layouts/610/13103",
            "templated": false
          },
          "https://api.amctheatres.com/rels/v2/seating-layout": {
            "href": "https://api.amctheatres.com/v2/seating-layouts/610/13103",
            "templated": false
          }
        }
      }
    ]
  }
}

Getting Started

  1. Authentication
  2. Affiliate Deep Linking
  3. Sandbox
Ordering Tickets
  1. General Admission Tickets
  2. Reserved Seating Tickets
Ordering Concessions
  1. Express Pickup Concessions
  2. Delivery To Seat Concessions
Refunding Orders
  1. Refunds

API Reference

  1. Errors
  1. Attributes
  2. Barcodes
  3. Concessions
  4. Concessions Categories
  5. Concessions Delivery Locations
  6. Concessions Delivery Times
  7. Concessions Pickup Times
  8. Embargoed Showtimes
  9. Fee Waiver
  10. Location Suggestions
  11. Locations
  12. Loyalty Accounts
  13. Loyalty Cards
  14. Markets
  15. Media
  16. Movie Confirmations
  17. Movies
  18. Orders
  19. Person
  20. Redemptions
  21. Refund Reasons
  22. Refunds
  23. Seating Layouts
  24. Showtimes
  25. States
  26. Theatre Seating Layouts
  27. Theatres
  28. Wallet
  29. Webhook