Productions API
Get Production IDs by Venue
Section titled “Get Production IDs by Venue”Get a list of production IDs currently playing at a venue within a date range.
| Method | GET |
| Route | /partner/v1/production/ids/byVenue/{venueId} |
Path Parameters
Section titled “Path Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
venueId | String | Yes | Venue identifier |
Query Parameters
Section titled “Query Parameters”Provide either ISO dates or local dates:
| Parameter | Type | Required | Description |
|---|---|---|---|
isoStartDate | String | Yes* | ISO 8601 start date (e.g., 2024-01-15T07:00:00Z) |
isoEndDate | String | Yes* | ISO 8601 end date |
localStartDate | String | Yes* | Local start date (YYYY-MM-DDTHH:MM:SS) |
localEndDate | String | Yes* | Local end date |
marketplaceId | String | No | Marketplace filter |
Response
Section titled “Response”Returns ProductionIdsResponse ordered by Atom Meter (popularity).
Get Production Details by IDs
Section titled “Get Production Details by IDs”Fetch full details for specific productions.
| Method | POST |
| Route | /partner/v1/production/details/byIds |
Request Body
Section titled “Request Body”{ "ids": ["B00809994585"]}Response
Section titled “Response”Returns ProductionDetailsResponse.
Search Productions by Name
Section titled “Search Productions by Name”Search for productions matching a name query.
| Method | GET |
| Route | /partner/v1/production/search/byName |
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
name | String | Yes | Production name to search for |
Response
Section titled “Response”Returns ProductionDetailsResponse.
Get Production by Vendor ID
Section titled “Get Production by Vendor ID”Look up an Atom production using your internal vendor production ID.
| Method | GET |
| Route | /partner/v1/productions/byVendorProductionId/{vendorProductionId} |
Path Parameters
Section titled “Path Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
vendorProductionId | String | Yes | Your internal production identifier |
Query Parameters
Section titled “Query Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
circuitId | String | No | Limit query to a specific circuit |
Response
Section titled “Response”Returns ProductionDetailsResponse.