Production Models

Request Models

GetProductionDetailsRequest

Used with the POST /partner/v1/production/details/byIds endpoint.

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

Field	Type	Required	Description
ids	List[String]	Yes	List of production IDs to look up
marketplaceId	String	No	Marketplace filter (defaults to US)
page	Int	No	Page number for pagination
pageSize	Int	No	Items per page (default: 25, max: 100)

Response Models

ProductionIdsResponse

Simple list of production IDs returned by the byVenue endpoint.

ProductionIdsResponse {
  ids: List[String]
}

ImageData

Image assets for a production.

ImageData {
  coverImageUrl: String,
  promoImageUrls: List[String]
}

Field	Type	Description
coverImageUrl	String	URL of the movie poster / cover image
promoImageUrls	List[String]	URLs for promotional images

TrailerData

TrailerData {
  trailerUrls: List[String]
}

Field	Type	Description
trailerUrls	List[String]	URLs to movie trailers

ProductionMedia

Combined media assets for a production.

ProductionMedia {
  imageData: ImageData,
  trailerData: TrailerData
}

Cast

Cast {
  name: String,
  characterName: Option[String]
}

Field	Type	Description
name	String	Actor name
characterName	String?	Character played

Crew

Crew {
  name: String,
  role: String
}

Field	Type	Description
name	String	Crew member name
role	String	Role (e.g., “Director”)

Contributors

Contributors {
  cast: List[Cast],
  crew: List[Crew]
}

ProductionDetail

Full production / movie details.

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]
}

Field	Type	Description
id	String	Unique production identifier
name	String	Movie title
productionMedia	ProductionMedia	Images and trailers
contributors	Contributors	Cast and crew
synopsis	String?	Movie description / plot summary
advisoryRating	String?	MPAA rating (e.g., “PG-13”, “R”)
genres	List[String]?	Genre list
runtimeMinutes	Int?	Movie runtime in minutes
releaseDate	String?	Release date (YYYY-MM-DD)
atomUserScore	Double?	Atom user score (0-10 scale)
productionUrl	String?	URL to the production page on Atom Tickets
distributor	String?	Film distributor
imdbId	String?	IMDb identifier
atomProductionId	String?	Internal Atom production ID

ProductionDetailsResponse

Top-level response for production detail queries.

ProductionDetailsResponse {
  productionDetails: List[ProductionDetail],
  pageInfo: Option[PageInfo]
}

Field	Type	Description
productionDetails	List[ProductionDetail]	List of production results
pageInfo	PageInfo	Pagination metadata