Atom Tickets Partner APIs

API Endpoints

Stage Endpoint
beta http://api-beta.atomtickets.com
gamma http://api-gamma.atomtickets.com
prod http://api.atomtickets.com

API Headers

Key Value Required
x-api-key Api key that atom tickets provides Yes
X-Atom-Partner Agreed upon value per partner if needed for use cases No

Limits

Testing 25 requests/sec baseline with a 50 requests/sec burst
Production Worked out between Atom Tickets and the Partner

Value Defaults and Limits

Field Default Max
radius 80km
pageSize 25 100
startDate/endDate difference 1 day 7 days

Common Models


  PageInfo(
    page: Int,
    pageSize: Int,
    totalPages: Int
  )
    
  LatLonPair(
    lat: Double,
    lon: Double
  )
      
  ISODateBounds (
    isoStartDate: String, // ISO8601 formatted date without milliseconds
    isoEndDate: String // ISO8601 formatted date without milliseconds
  )
      
  LocalDateBounds (
    localStartDate: String, // YYYY-MM-DDTHH:MM:SS (no timezone)
    localEndDate: String // YYYY-MM-DDTHH:MM:SS (no timezone)
  )
      

Request Models

Venues

  GetVenueDetailsRequest(
    ids: List[String],
    location: Option[LatLonPair],
    page: Option[Int],
    pageSize: Option[Int]
  )
      

Productions

  GetProductionDetailsRequest(
    ids: List[String],
    marketplaceId: Option[String], // US by default
    page: Option[Int],
    pageSize: Option[Int]
  )
      

Showtimes

  GetShowtimeDetailsRequest(
    ids: List[String],
    page: Option[Int],
    pageSize: Option[Int]
  )
      
  GetShowtimesForVenuesRequest (
    venueIds: Set[String],
    productionIds: Option[Set[String]],
    isoDateBounds: Option[ISODateBounds],
    localDateBounds: Option[LocalDateBounds],
    includeProductionDetails: Option[Boolean],
    marketplaceId: Option[String]
  )
      

Response Models

Venues

  Address(
    line: String,
    city: String,
    state: String,
    postal: String,
    lat: Double,
    lon: Double
  )
      
  Properties(
    supportsConcessions: Boolean,
    supported: Boolean
  )
      
  Venue(
    id: String,
    name: String,
    address: Address,
    properties: Properties,
    venueUrl: Option[String],
    atomVenueId: Option[String]
  )
      
  VenueDetail(
    venue: Venue,
    kmDistance: Option[Double]
  )
      
  VenueDetailsResponse(
    venueDetails: List[VenueDetail],
    pageInfo: Option[PageInfo]
  )
      

Productions

  ProductionIdsResponse(
    ids: List[String]
  )
      
  ImageData(
    coverImageUrl: String,
    promoImageUrls: List[String]
  )
      
  TrailerData(
    trailerUrls: List[String]
  )
      
  ProductionMedia(
    imageData: ImageData,
    trailerData: TrailerData
  )
      
  Cast(
    name: String,
    characterName: Option[String]
  )
      
  Crew (
    name: String,
    role: String
  )
      
  Contributors (
    cast: List[Cast],
    crew: List[Crew]
  )
      
  ProductionDetail(
    id: String,
    name: String,
    productionMedia: ProductionMedia,
    contributors: Contributors,
    synopsis: Option[String],
    advisoryRating: Option[String],
    genres: Option[List[String]],
    runtimeMinutes: Option[Int],
    releaseDate: Option[String], // YYYY-MM-DD
    atomUserScore: Option[Double],
    productionUrl: Option[String],
    distributor: Option[String],
    imdbId: Option[String],
    atomProductionId: Option[String]
  )
      
  ProductionDetailsResponse(
    productionDetails: List[ProductionDetail],
    pageInfo: Option[PageInfo]
  )
      

Showtimes

  Attribute(
    id: String,
    type: String,
    iconUrl: String,
    friendlyName: Option[String],
    description: Option[String]
  )
      
  Price(
    value: BigDecimal,
    currencyCode: String
  )
      
  Offer(
    label: String,
    price: Price
  )
      
  OfferData(
    offers: List[Offer]
  )
      
  ShowtimeDetail(
    showtimeId: String,
    productionId: String,
    venueId: String,
    offerData: OfferData,
    utcShowtimeStart: String, // iso8601 formatted date without milliseconds
    localShowtimeStart: String, // iso8601 formatted date without milliseconds
    attributes: List[String], // attribute key for attribute map,
    checkoutUrl: Option[String],
    availableInventory: Option[Int],
    tags: Option[Set[String]] // used for special event showtimes
  )
      
  PreOrderDetail(
    productionId: String,
    venueId: String,
    showtimeDays: List[String]
  )
      
  ShowtimeDetailsResponse(
    showtimeDetails: List[ShowtimeDetail],
    preOrderDetails: List[PreOrderDetail],
    attributeMap: Map[String, Attribute]
  )
      
  VenueShowtimeDetails (
    showtimeDetails: List[ShowtimeDetail],
    preOrderDetails: List[PreOrderDetail]
  )
      
  ShowtimeDetailsForVenuesResponse (
    venueShowtimeDetailsMap: Map[String, VenueShowtimeDetails],
    attributeMap: Map[String, Attribute],
    productionDetailsMap: Map[String, ProductionDetail]
  )
      

APIs

Ping

Verb Route Description Required Query Params/Request Model Optional Query Params Response
GET /partner/ping Ping partner API for health check
Requires 'x-api-key'
No Response Body -- Http Status Code 200 if health check is successful

Venues

Verb Route Description Required Query Params/Request Model Optional Query Params Response
GET /partner/v1/venue/details/byLocation Query for venues by location
  • lat
  • lon
  • radius
  • page
  • pageSize
POST /partner/v1/venue/details/byIds Query for venues by Ids
GET /partner/v1/venue/details/search Query for venues by name
  • term - search query for venue names
  • lat
  • lon
  • radius
  • pageSize
  • page
GET /partner/v1/venues/byVendorVenueId/<vendorVenueId> Query for venue by Vendor Venue Id
  • circuitId - limit query to specific circuit

Productions

Verb Route Description Required Query Params/Request Model Optional Query Params Response
GET /partner/v1/production/ids/byVenue/<venueId> Get the production ids for the venue that are playing during the startDate/endDate inclusive

Either

  • isoStartDate - ISO8601 formatted date without milliseconds
  • isoEndDate - ISO8601 formatted date without milliseconds

Or

  • localStartDate - YYYY-MM-DDTHH:MM:SS (no timezone)
  • localEndDate - YYYY-MM-DDTHH:MM:SS (no timezone)
  • marketplaceId
POST /partner/v1/production/details/byIds Get the production details for the production ids
GET /partner/v1/production/search/byName Search for production details by name
  • name - production name to search for
GET /partner/v1/productions/byVendorProductionId/<vendorProductionId> Query for production by Vendor Production Id
  • circuitId - limit query to specific circuit

Showtimes

Verb Route Description Required Query Params/Request Model Optional Query Params Response
GET /partner/v1/showtime/details/byVenue/<venueId>

Get the showtimes for the venue for the startDate/endDate inclusive

This includes preOrder showtime data

Either

  • isoStartDate - ISO8601 formatted date without milliseconds
  • isoEndDate - ISO8601 formatted date without milliseconds

Or

  • localStartDate - YYYY-MM-DDTHH:MM:SS (no timezone)
  • localEndDate - YYYY-MM-DDTHH:MM:SS (no timezone)
  • productionIds - comma separated string list of production ids
POST /partner/v1/showtime/details/byIds Get the showtime details for the showtime ids
POST /partner/v1/showtime/details/forVenues Get the showtime details for the venues
GET /partner/v1/venues/<venueId>/showtimes/byVendorShowtimeId/<vendorShowtimeId>

Query for showtime by venue id and Vendor Showtime Id

  • circuitId - limit query to specific circuit
GET /partner/v1/venues/byVendorVenueId/<vendorVenueId>/showtimes/byVendorShowtimeId/<vendorShowtimeId>

Query for showtime by Vendor Venue Id and Vendor Showtime Id

  • circuitId - limit query to specific circuit

Examples

URL http://api-beta.atomtickets.com/partner/v1/venue/details/byLocation
Header x-api-key
Query Params lat=34.0195&lon=-118.4912&radius=50&pageSize=2
cURL Request
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/venue/details/byLocation?lat=34.0195&lon=-118.4912&radius=50&pageSize=2' \
  -H 'x-api-key: {AtomPartnerApiKey}'
              
Response
{
    "venueDetails": [
        {
            "venue": {
                "id": "C00110921804",
                "name": "AMC Loews Broadway 4",
                "address": {
                    "line": "1441 Third Street Promenade",
                    "city": "Santa Monica",
                    "state": "CA",
                    "postal": "90401",
                    "lat": 34.014801025390625,
                    "lon": -118.49500274658203
                },
                "properties": {
                    "supportsConcessions": true,
                    "supported": true
                },
                "venueUrl": "http://rw-beta.atomtickets.com/theaters/redirect/C00110921804",
                "atomVenueId": "1341"
            },
            "kmDistance": 0.628527332801801
        },
        {
            "venue": {
                "id": "C00401723167",
                "name": "AMC Santa Monica 7",
                "address": {
                    "line": "1310 3rd Street",
                    "city": "Santa Monica",
                    "state": "CA",
                    "postal": "90401",
                    "lat": 34.016693115234375,
                    "lon": -118.49755859375
                },
                "properties": {
                    "supportsConcessions": true,
                    "supported": true
                },
                "venueUrl": "http://rw-beta.atomtickets.com/theaters/redirect/C00401723167",
                "atomVenueId": "44608"
            },
            "kmDistance": 0.6647355560508852
        }
    ],
    "pageInfo": {
        "page": 1,
        "pageSize": 2,
        "totalPages": 52
    }
}
              

URL http://api-beta.atomtickets.com/partner/v1/venue/details/byIds
Header x-api-key
cURL Request
curl -X POST \
  https://api-beta.atomtickets.com/partner/v1/venue/details/byIds \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {AtomPartnerApiKey}' \
  -d '{
    "ids":["C0057070265"],
    "location":{
        "lat":34.0195,
        "lon":-118.4912
    }
}'
              
Request Body
{
    "ids": ["C0057070265"],
    "location":{
        "lat":34.0195,
        "lon":-118.4912
    }
}
              
Response
{
    "venueDetails": [
        {
            "venue": {
                "id": "C0057070265",
                "name": "Regal LA Live & 4DX",
                "address": {
                    "line": "1000 West Olympic Boulevard",
                    "city": "Los Angeles",
                    "state": "CA",
                    "postal": "90015",
                    "lat": 34.031402587890625,
                    "lon": -118.46971130371094
                },
                "properties": {
                    "supportsConcessions": false,
                    "supported": false
                },
                "venueUrl": "http://rw-beta.atomtickets.com/theaters/redirect/C0057070265",
                "atomVenueId": "20263"
            },
            "kmDistance": 2.383671824436259
        }
    ]
}
              

URL http://api-beta.atomtickets.com/partner/v1/venue/details/search
Header x-api-key
Query Params term=amc&lat=34.0195&lon=-118.4912&radius=50&pageSize=2
cURL Request
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/venue/details/search?term=amc&lat=34.0195&lon=-118.4912&radius=50&pageSize=2' \
  -H 'x-api-key: {AtomPartnerApiKey}'
              
Response
{
    "venueDetails": [
        {
            "venue": {
                "id": "C00110921804",
                "name": "AMC Loews Broadway 4",
                "address": {
                    "line": "1441 Third Street Promenade",
                    "city": "Santa Monica",
                    "state": "CA",
                    "postal": "90401",
                    "lat": 34.014801025390625,
                    "lon": -118.49500274658203
                },
                "properties": {
                    "supportsConcessions": true,
                    "supported": true
                },
                "venueUrl": "http://rw-beta.atomtickets.com/theaters/redirect/C00110921804",
                "atomVenueId": "1341"
            },
            "kmDistance": 0.628527332801801
        },
        {
            "venue": {
                "id": "C00401723167",
                "name": "AMC Santa Monica 7",
                "address": {
                    "line": "1310 3rd Street",
                    "city": "Santa Monica",
                    "state": "CA",
                    "postal": "90401",
                    "lat": 34.016693115234375,
                    "lon": -118.49755859375
                },
                "properties": {
                    "supportsConcessions": true,
                    "supported": true
                },
                "venueUrl": "http://rw-beta.atomtickets.com/theaters/redirect/C00401723167",
                "atomVenueId": "11729"
            },
            "kmDistance": 0.6647355560508852
        }
    ],
    "pageInfo": {
        "page": 1,
        "pageSize": 2,
        "totalPages": 10
    }
}
              

URL http://api-beta.atomtickets.com/partner/v1/venues/byVendorVenueId/0001
Header x-api-key
cURL Request
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/venues/byVendorVenueId/0001' \
  -H 'x-api-key: {AtomPartnerApiKey}'
              
Response
{
    "venueDetails": [
        {
            "venue": {
                "id": "C00889608713",
                "name": "Flix Brewhouse - Des Moines",
                "address": {
                    "line": "3800 Merle Hay Road",
                    "city": "Des Moines",
                    "state": "IA",
                    "postal": "50310",
                    "lat": 41.629539489746094,
                    "lon": -93.69798278808594
                },
                "properties": {
                    "supportsConcessions": true,
                    "supported": true
                },
                "venueUrl": "http://rw-beta.atomtickets.com/theaters/redirect/C00889608713",
                "atomVenueId": "7364"
            }
        }
    ]
}
              

URL http://api-beta.atomtickets.com/partner/v1/production/ids/byVenue/C0057070265
Header x-api-key
Query Params isoStartDate=2018-09-13T07:00:00Z&isoEndDate=2018-09-14T07:00:00Z
cURL Request
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/production/ids/byVenue/C00110921804?isoStartDate=2019-10-10T07:00:00Z&isoEndDate=2019-10-11T07:00:00Z' \
  -H 'x-api-key: {AtomPartnerApiKey}'
              
Response
{
    "ids": [
        "B0093420570",
        "B00437681129",
        "B00685932020",
        "B00309261556"
    ]
}
              

URL http://api-beta.atomtickets.com/partner/v1/production/details/byIds
Header x-api-key
cURL Request
curl -X POST \
  https://api-beta.atomtickets.com/partner/v1/production/details/byIds \
  -H 'x-api-key: {AtomPartnerApiKey}' \
  -d '{
    "ids":["B00809994585"]
}'
              
Request Body
{
    "ids":["B00809994585"]
}
              
Response
{
    "productionDetails": [
        {
            "id": "B00809994585",
            "name": "The Predator",
            "productionMedia": {
                "imageData": {
                    "coverImageUrl": "https://images.atomtickets.com/image/upload/w_520,h_780,q_auto/v1/ingestion-images-archive/archive/rm3117827584.jpg",
                    "promoImageUrls": [
                        "https://images.atomtickets.com/image/upload/h_960,q_auto/v1526062779/ingestion-images-archive/archive/1526062778201_227902_cops_1.png"
                    ]
                },
                "trailerData": {
                    "trailerUrls": []
                }
            },
            "contributors": {
                "cast": [
                    {
                        "name": "Boyd Holbrook",
                        "characterName": "Quinn McKenna"
                    }
                ],
                "crew": [
                    {
                        "name": "Shane Black",
                        "role": "Director"
                    }
                ]
            },
            "synopsis": "When a young boy accidentally triggers the universe's most lethal hunters return to Earth, only a ragtag crew of ex-soldiers and a disgruntled science teacher can prevent the end of the human race.",
            "advisoryRating": "No Rating",
            "genres": [
                "Action",
                "Adventure",
                "Horror",
                "Sci-Fi",
                "Thriller"
            ],
            "runtimeMinutes": 0,
            "releaseDate": "2018-09-14",
            "atomUserScore": 10.0,
            "productionUrl": "http://rw-beta.atomtickets.com/movies/redirect/B00809994585",
            "imdbId": "3829266",
            "atomProductionId":"227902"
        }
    ]
}
              

URL http://api-beta.atomtickets.com/partner/v1/production/search/byName
Header x-api-key
Query Params name=Captain Marvel
cURL Request
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/production/search/byName?name=Captain%20Marvel' \
  -H 'x-api-key: {AtomPartnerApiKey}'
              
Response
{
    "productionDetails": [
        {
            "id": "B00362154100",
            "name": "Captain Marvel",
            "productionMedia": {
                "imageData": {
                    "coverImageUrl": "https://images.atomtickets.com/image/upload/w_520,h_780,q_auto/v1/ingestion-images-archive/archive/rm123368960.jpg",
                    "promoImageUrls": []
                },
                "trailerData": {
                    "trailerUrls": [
                        "https://www.totaleclips.com/Bounce/b?eclipid=e162647&bitrateid=449&vendorid=17871"
                    ]
                }
            },
            "contributors": {
                "cast": [
                    {
                        "name": "Brie Larson",
                        "characterName": "Carol Danvers, Vers, Captain Marvel"
                    }
                ],
                "crew": [
                    {
                        "name": "Anna Boden",
                        "role": "Director"
                    }
                ]
            },
            "synopsis": "The story follows Carol Danvers as she becomes one of the universe's most powerful heroes when Earth is caught in the middle of a galactic war between two alien races.  Set in the 1990s, Captain Marvel is an all-new adventure from a previously unseen period in the history of the Marvel Cinematic Universe.",
            "advisoryRating": "PG-13",
            "genres": [
                "Action/Adventure",
                "SciFi/Fantasy"
            ],
            "runtimeMinutes": 124,
            "releaseDate": "2019-03-08",
            "atomUserScore": 6.7,
            "productionUrl": "http://rw-beta.atomtickets.com/movies/redirect/B00362154100",
             "imdbId": "4154664"
        }
    ]
}
              

URL http://api-beta.atomtickets.com/partner/v1/productions/byVendorProductionId/0000001176
Header x-api-key
cURL Request
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/productions/byVendorProductionId/0000001176' \
  -H 'x-api-key: {AtomPartnerApiKey}'
              
Response
{
    "productionDetails": [
        {
            "id": "B00849252296",
            "name": "The Last Movie",
            "productionMedia": {
                "imageData": {
                    "coverImageUrl": "https://images.atomtickets.com/image/upload/w_520,h_780,q_auto/v1/ingestion-images-archive/archive/rm1217998848.jpg",
                    "promoImageUrls": []
                },
                "trailerData": {
                    "trailerUrls": [
                        "https://www.totaleclips.com/Bounce/b?eclipid=e164394&bitrateid=449&vendorid=17871"
                    ]
                }
            },
            "contributors": {
                "cast": [
                    {
                        "name": "Julie Adams",
                        "characterName": "Mrs. Anderson"
                    }
                ],
                "crew": [
                    {
                        "name": "Dennis Hopper",
                        "role": "Director"
                    }
                ]
            },
            "synopsis": "The Last Movie follows a Hollywood movie crew in the midst of making a western in a remote Peruvian village. When production wraps, Hopper, as the baleful stuntman Kansas, remains, attempting to find redemption in the isolation of Peru and the arms of a former prostitute. Meanwhile, the local Indians have taken over the abandoned set and begun to stage a ritualistic re-enactment of the production - with Kansas as their sacrificial lamb.",
            "advisoryRating": "R",
            "genres": [
                "Drama"
            ],
            "runtimeMinutes": 108,
            "releaseDate": "2018-08-03",
            "productionUrl": "http://rw-beta.atomtickets.com/movies/redirect/B00849252296",
             "imdbId":"5836316"
        }
    ]
}
              

URL http://api-beta.atomtickets.com/partner/v1/showtime/details/byVenue/C0057070265
Header
x-api-key
X-Atom-Partner
              
Query Params isoStartDate=2018-09-14T21:00:00Z&isoEndDate=2018-09-14T21:30:00Z
cURL Request
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/showtime/details/byVenue/C00110921804?isoStartDate=2018-09-14T07:00:00Z&isoEndDate=2018-09-15T07:00:00Z' \
  -H 'x-api-key: {AtomPartnerApiKey}'
              
Response
{
    "showtimeDetails": [
        {
            "showtimeId": "D00747321039",
            "productionId": "B00879153184",
            "venueId": "C0057070265",
            "offerData": {
                "offers": [
                    {
                        "label": "Ticket",
                        "price": {
                            "value": 12.75,
                            "currencyCode": "USD"
                        }
                    }
                ]
            },
            "utcShowtimeStart": "2018-09-14T20:30:00Z",
            "localShowtimeStart": "2018-09-14T13:30:00-07:00",
            "attributes": [
                "STADIUM-SEATING",
                "CC"
            ]
        },
        {
            "showtimeId": "D00383546016",
            "productionId": "B00651431218",
            "venueId": "C0057070265",
            "offerData": {
                "offers": [
                    {
                        "label": "Matinee",
                        "price": {
                            "value": 14,
                            "currencyCode": "USD"
                        }
                    },
                    {
                        "label": "Child",
                        "price": {
                            "value": 13,
                            "currencyCode": "USD"
                        }
                    },
                    {
                        "label": "Senior",
                        "price": {
                            "value": 13,
                            "currencyCode": "USD"
                        }
                    }
                ]
            },
            "utcShowtimeStart": "2018-09-14T20:40:00Z",
            "localShowtimeStart": "2018-09-14T13:40:00-07:00",
            "attributes": [
                "CC",
                "DV",
                "STADIUM-SEATING",
                "RESERVED"
            ]
        }
    ],
    "preOrderDetails": [
        {
            "productionId": "B00856886544",
            "venueId": "C0057070265",
            "showtimeDays": [
                "2018-10-06T00:00:00-07:00"
            ]
        },
        {
            "productionId": "B00775577087",
            "venueId": "C0057070265",
            "showtimeDays": [
                "2018-09-25T00:00:00-07:00",
                "2018-09-26T00:00:00-07:00",
                "2018-09-27T00:00:00-07:00",
                "2018-09-29T00:00:00-07:00",
                "2018-10-02T00:00:00-07:00"
            ]
        }
    ],
    "attributeMap": {
        "RESERVED": {
            "id": "RESERVED",
            "iconUrl": "https://images.atomtickets.com/image/upload/q_auto/v1/client-image-repo/attributes/RESERVED_V2_1517873333535.png,
            "friendlyName": "Reserved Seating",
            "description": "Description"
        }
    }
}
              

URL http://api-beta.atomtickets.com/partner/v1/showtime/details/byIds
Header
x-api-key
              
cURL Request
curl -X POST \
  https://api-beta.atomtickets.com/partner/v1/showtime/details/byIds \
  -H 'x-api-key: {AtomPartnerApiKey}' \
  -d '{
    "ids":["D00776442169"]
}'
              
Request Body
{
    "ids":["D00747321039"]
}
              
Response
{
    "showtimeDetails": [
        {
            "showtimeId": "D00776442169",
            "productionId": "B00418470916",
            "venueId": "C0057070265",
            "offerData": {
                "offers": []
            },
            "utcShowtimeStart": "2018-09-12T20:30:00Z",
            "localShowtimeStart": "2018-09-12T13:30:00-07:00",
            "attributes": [
                "STADIUM-SEATING",
                "CC"
            ],
            "checkoutUrl": "http://rw-beta.atomtickets.com/checkout/redirect?productionId=B00418470916&venueId=C0057070265&localShowtime=2018-09-12T13:30:00&iref=atomapi",
            "availableInventory": 1
        }
    ],
    "preOrderDetails": [],
    "attributeMap": {
        "STADIUM-SEATING": {
            "id": "STADIUM-SEATING",
            "type": "SECONDARY",
            "iconUrl": "https://images.atomtickets.com/image/upload/q_auto/v1/client-image-repo/attributes/STADIUM-SEATING_V2_1517873031977.png",
            "friendlyName": "Stadium seating",
            "description": "Stadium seating."
        },
        "CC": {
            "id": "CC",
            "type": "SECONDARY",
            "iconUrl": "https://images.atomtickets.com/image/upload/q_auto/v1/client-image-repo/attributes/CC_V2_1517872363908.png",
            "friendlyName": "CC",
            "description": "Closed Captioning devices display a movie's dialogue and sound effects as text; captions are not shown on the main screen. Devices available by request."
        },
        "STANDARD-FORMAT": {
            "id": "STANDARD-FORMAT",
            "type": "SECONDARY",
            "iconUrl": "https://images.atomtickets.com/image/upload/q_auto/v1/client-image-repo/attributes/STANDARD-FORMAT_V2_1517872101839.png",
            "friendlyName": "Standard Format",
            "description": "Traditional movie format with 16:9 aspect ratio."
        }
    }
}
              

URL http://api-beta.atomtickets.com/partner/v1/showtime/details/forVenues
Header
x-api-key
X-Atom-Partner
              
cURL Request
curl -X POST \
  https://api-beta.atomtickets.com/partner/v1/showtime/details/forVenues \
  -H 'x-api-key: b4fUkljP8a3Vve9KZCsbN5OGszb72N1p2D0ZtSGH' \
  -d '{
    "venueIds":["C0057070265","C00110921804","C00401723167","C00928817799"],
    "isoDateBounds":{
        "isoStartDate":"2019-02-25T07:00:00Z",
        "isoEndDate":"2019-02-26T07:00:00Z"
    },
    "includeProductionDetails":true
}'
              
Request Body
{
    "venueIds":["C0057070265","C00110921804","C00401723167","C00928817799"],
    "isoDateBounds":{
        "isoStartDate":"2019-02-25T07:00:00Z",
        "isoEndDate":"2019-02-26T07:00:00Z"
    },
    "includeProductionDetails":true
}
              
Response
{
    "venueShowtimeDetailsMap": {
        "C00110921804": {
            "showtimeDetails": [],
            "preOrderDetails": [{
                "productionId": "B00362154100",
                "venueId": "C00110921804",
                "showtimeDays": [
                    "2019-03-07T00:00:00-08:00",
                    "2019-03-08T00:00:00-08:00",
                    "2019-03-09T00:00:00-08:00",
                    "2019-03-10T00:00:00-08:00",
                    "2019-03-11T00:00:00-08:00",
                    "2019-03-12T00:00:00-08:00",
                    "2019-03-13T00:00:00-08:00",
                    "2019-03-14T00:00:00-08:00",
                    "2019-03-15T00:00:00-08:00",
                    "2019-03-16T00:00:00-08:00",
                    "2019-03-17T00:00:00-08:00",
                    "2019-03-18T00:00:00-08:00",
                    "2019-03-19T00:00:00-08:00",
                    "2019-03-20T00:00:00-08:00",
                    "2019-03-21T00:00:00-08:00"
                ]
            }]
        },
        "C00401723167": {
            "showtimeDetails": [{
                    "showtimeId": "D00841132746",
                    "productionId": "B00629445690",
                    "venueId": "C00401723167",
                    "offerData": {
                        "offers": []
                    },
                    "utcShowtimeStart": "2019-02-25T19:30:00Z",
                    "localShowtimeStart": "2019-02-25T11:30:00-08:00",
                    "attributes": [
                        "RESERVED",
                        "DVS"
                    ]
                },
                {
                    "showtimeId": "D00877858635",
                    "productionId": "B00629445690",
                    "venueId": "C00401723167",
                    "offerData": {
                        "offers": []
                    },
                    "utcShowtimeStart": "2019-02-25T22:00:00Z",
                    "localShowtimeStart": "2019-02-25T14:00:00-08:00",
                    "attributes": [
                        "RESERVED",
                        "DVS",
                        "REALD3D"
                    ]
                }
            ],
            "preOrderDetails": [{
                "productionId": "B00178318857",
                "venueId": "C00401723167",
                "showtimeDays": [
                    "2019-03-02T00:00:00-08:00"
                ]
            }]
        }
    },
    "attributeMap": {
        "DVS": {
            "id": "DVS",
            "iconUrl": "https://images.atomtickets.com/image/upload/q_auto/v1/client-image-repo/attributes/DVS_V2_1517871554190.png",
            "friendlyName": "Descriptive Video",
            "description": "Description"
        }
    },
    "productionDetailsMap": {
        "B00949090095": {
            "id": "B00949090095",
            "name": "Gone with the Wind 80th Anniversary",
            "productionMedia": {
                "imageData": {
                    "coverImageUrl": "https://images.atomtickets.com/image/upload/ingestion-images-archive-prod/archive/coming_soon_poster.jpg",
                    "promoImageUrls": []
                },
                "trailerData": {
                    "trailerUrls": []
                }
            },
            "contributors": {
                "cast": [],
                "crew": []
            },
            "synopsis": "",
            "advisoryRating": "No Rating",
            "genres": [
                ""
            ],
            "runtimeMinutes": 0
        }
    }
}
              

URL http://api-beta.atomtickets.com/partner/v1/venues/C00682352378/showtimes/byVendorShowtimeId/19
Header
x-api-key
X-Atom-Partner
              
cURL Request
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/venues/C00682352378/showtimes/byVendorShowtimeId/19' \
  -H 'x-api-key: {AtomPartnerApiKey}'
              
Response
{
    "showtimeDetails": [
        {
            "showtimeId": "D00999351728",
            "productionId": "B00849252296",
            "venueId": "C00682352378",
            "offerData": {
                "offers": []
            },
            "utcShowtimeStart": "2019-09-13T20:05:00Z",
            "localShowtimeStart": "2019-09-13T16:05:00-04:00",
            "attributes": [
                "RESERVED"
            ],
            "checkoutUrl": "http://rw-beta.atomtickets.com/checkout/redirect?productionId=B00849252296&venueId=C00682352378&localShowtime=2019-09-13T16:05:00&iref=atomapi",
            "availableInventory": 1
        }
    ],
    "preOrderDetails": [],
    "attributeMap": {
        "RESERVED": {
            "id": "RESERVED",
            "type": "SECONDARY",
            "iconUrl": "https://images.atomtickets.com/image/upload/q_auto/v1/client-image-repo/attributes/RESERVED_V2_1517873333535.png",
            "friendlyName": "Reserved Seating",
            "description": "This showtime features reserved seating so you can pick your seats ahead of time."
        },
        "STANDARD-FORMAT": {
            "id": "STANDARD-FORMAT",
            "type": "SECONDARY",
            "iconUrl": "https://images.atomtickets.com/image/upload/q_auto/v1/client-image-repo/attributes/STANDARD-FORMAT_V2_1517872101839.png",
            "friendlyName": "Standard Format",
            "description": "Traditional movie format with 16:9 aspect ratio."
        }
    }
}
              

URL http://api-beta.atomtickets.com/partner/v1/venues/byVendorVenueId/511/showtimes/byVendorShowtimeId/19
Header
x-api-key
X-Atom-Partner
              
cURL Request
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/venues/byVendorVenueId/511/showtimes/byVendorShowtimeId/19' \
  -H 'x-api-key: {AtomPartnerApiKey}'
              
Response
{
    "showtimeDetails": [
        {
            "showtimeId": "D00999351728",
            "productionId": "B00849252296",
            "venueId": "C00682352378",
            "offerData": {
                "offers": []
            },
            "utcShowtimeStart": "2019-09-13T20:05:00Z",
            "localShowtimeStart": "2019-09-13T16:05:00-04:00",
            "attributes": [
                "RESERVED"
            ],
            "checkoutUrl": "http://rw-beta.atomtickets.com/checkout/redirect?productionId=B00849252296&venueId=C00682352378&localShowtime=2019-09-13T16:05:00&iref=atomapi",
            "availableInventory": 1
        }
    ],
    "preOrderDetails": [],
    "attributeMap": {
        "RESERVED": {
            "id": "RESERVED",
            "type": "SECONDARY",
            "iconUrl": "https://images.atomtickets.com/image/upload/q_auto/v1/client-image-repo/attributes/RESERVED_V2_1517873333535.png",
            "friendlyName": "Reserved Seating",
            "description": "This showtime features reserved seating so you can pick your seats ahead of time."
        },
        "STANDARD-FORMAT": {
            "id": "STANDARD-FORMAT",
            "type": "SECONDARY",
            "iconUrl": "https://images.atomtickets.com/image/upload/q_auto/v1/client-image-repo/attributes/STANDARD-FORMAT_V2_1517872101839.png",
            "friendlyName": "Standard Format",
            "description": "Traditional movie format with 16:9 aspect ratio."
        }
    }
}