Skip to content
Atom Tickets Partner API

Showtime Examples

Get Showtimes by Venue

Section titled “Get Showtimes by Venue”

Get showtimes at a venue for a specific date range.

Request

Section titled “Request”
Terminal window
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

Section titled “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"
    }
  }
}

Get Showtimes by IDs

Section titled “Get Showtimes by IDs”

Look up specific showtimes with full details including checkout URL.

Request

Section titled “Request”
Terminal window
curl -X POST \
  https://api-beta.atomtickets.com/partner/v1/showtime/details/byIds \
  -H 'x-api-key: {AtomPartnerApiKey}' \
  -d '{
    "ids": ["D00776442169"]
  }'

Response

Section titled “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."
    }
  }
}

Get Showtimes for Multiple Venues

Section titled “Get Showtimes for Multiple Venues”

Batch query with production details included.

Request

Section titled “Request”
Terminal window
curl -X POST \
  https://api-beta.atomtickets.com/partner/v1/showtime/details/forVenues \
  -H 'x-api-key: {AtomPartnerApiKey}' \
  -d '{
    "venueIds": ["C0057070265", "C00110921804", "C00401723167"],
    "isoDateBounds": {
      "isoStartDate": "2019-02-25T07:00:00Z",
      "isoEndDate": "2019-02-26T07:00:00Z"
    },
    "includeProductionDetails": true
  }'

Response

Section titled “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"
          ]
        }
      ]
    },
    "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
    }
  }
}

Get Showtime by Vendor Showtime ID

Section titled “Get Showtime by Vendor Showtime ID”

Look up a showtime using your vendor showtime ID and an Atom venue ID.

Request

Section titled “Request”
Terminal window
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/venues/C00682352378/showtimes/byVendorShowtimeId/19' \
  -H 'x-api-key: {AtomPartnerApiKey}'

Response

Section titled “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."
    }
  }
}

Get Showtime by Vendor Venue and Vendor Showtime IDs

Section titled “Get Showtime by Vendor Venue and Vendor Showtime IDs”

Look up a showtime using both your vendor venue ID and vendor showtime ID.

Request

Section titled “Request”
Terminal window
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/venues/byVendorVenueId/511/showtimes/byVendorShowtimeId/19' \
  -H 'x-api-key: {AtomPartnerApiKey}'

Response

Section titled “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."
    }
  }
}