Showtimes API

Get Showtimes by Venue

Get all showtimes at a specific venue within a date range.

Method	GET
Route	/partner/v1/showtime/details/byVenue/{venueId}

Path Parameters

Parameter	Type	Required	Description
venueId	String	Yes	Venue identifier

Query Parameters

Provide either ISO dates or local dates:

Parameter	Type	Required	Description
isoStartDate	String	Yes*	ISO 8601 start date
isoEndDate	String	Yes*	ISO 8601 end date
localStartDate	String	Yes*	Local start date
localEndDate	String	Yes*	Local end date
productionIds	String	No	Comma-separated list of production IDs to filter by

Response

Returns ShowtimeDetailsResponse including pre-order details and an attribute map.

---

Get Showtimes by IDs

Look up specific showtimes by their IDs.

Method	POST
Route	/partner/v1/showtime/details/byIds

Request Body

GetShowtimeDetailsRequest

{
  "ids": ["D00747321039"]
}

Response

Returns ShowtimeDetailsResponse.

---

Get Showtimes for Multiple Venues

Batch-query showtimes across multiple venues. Optionally include full production details in the response.

Method	POST
Route	/partner/v1/showtime/details/forVenues

Request Body

GetShowtimesForVenuesRequest

{
  "venueIds": ["C0057070265", "C00110921804"],
  "isoDateBounds": {
    "isoStartDate": "2024-01-15T07:00:00Z",
    "isoEndDate": "2024-01-16T07:00:00Z"
  },
  "includeProductionDetails": true
}

Response

Returns ShowtimeDetailsForVenuesResponse with showtimes grouped by venue ID.

---

Get Showtime by Vendor Showtime ID

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

Method	GET
Route	/partner/v1/venues/{venueId}/showtimes/byVendorShowtimeId/{vendorShowtimeId}

Path Parameters

Parameter	Type	Required	Description
venueId	String	Yes	Atom venue identifier
vendorShowtimeId	String	Yes	Your internal showtime identifier

Query Parameters

Parameter	Type	Required	Description
circuitId	String	No	Limit query to a specific circuit

Response

Returns ShowtimeDetailsResponse.

---

Get Showtime by Vendor Venue and Showtime IDs

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

Method	GET
Route	/partner/v1/venues/byVendorVenueId/{vendorVenueId}/showtimes/byVendorShowtimeId/{vendorShowtimeId}

Path Parameters

Parameter	Type	Required	Description
vendorVenueId	String	Yes	Your internal venue identifier
vendorShowtimeId	String	Yes	Your internal showtime identifier

Query Parameters

Parameter	Type	Required	Description
circuitId	String	No	Limit query to a specific circuit

Response

Returns ShowtimeDetailsResponse.