{"openapi":"3.0.3","info":{"title":"Box Observer API","version":"1.0.0","description":"Read-only cinema, schedule, price and seat-observation contract. Production access requires an explicit organization grant and a scoped API key or an active Clerk session. Cinema data is filtered to granted countries and markets. Health and readiness do not require credentials. Documentation: https://docs.boxobserver.com/api/"},"servers":[{"url":"https://api.boxobserver.com","description":"Production"}],"security":[{"ClerkSession":[]},{"ApiKey":[]}],"components":{"securitySchemes":{"ClerkSession":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"A valid Box Observer Clerk session with an active organization, membership and API grant."},"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"bo_live_…","description":"A scoped, expiring organization API key. Provisioned by Box Observer; store server-side. Revocation applies on the next request."}},"schemas":{"Readiness":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"service":{"type":"string","enum":["box-observer-api"]},"productReadVersion":{"type":"integer"},"dependencies":{"type":"object","properties":{"dataService":{"type":"string","enum":["ready"]}},"required":["dataService"]}},"required":["ok","service","dependencies"]},"Problem":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"requestId":{"type":"string"}},"required":["type","title","status","detail","requestId"]},"AuthenticatedAccount":{"type":"object","properties":{"authentication":{"type":"string","enum":["clerk","apiKey"]},"keyId":{"type":"string","nullable":true},"userId":{"type":"string","nullable":true},"organizationId":{"type":"string","nullable":true},"access":{"type":"object","properties":{"scopes":{"type":"array","items":{"type":"string","enum":["catalog:read","schedules:read","availability:read","history:read"]}},"countryCodes":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2}},"mode":{"type":"string","enum":["operator_markets","countries"]},"operatorId":{"type":"string","nullable":true}},"required":["scopes","countryCodes","mode","operatorId"]},"capabilities":{"type":"object","properties":{"countryFiltering":{"type":"boolean","enum":[true]},"availableCountryCodes":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2}}},"required":["countryFiltering","availableCountryCodes"]},"limits":{"type":"object","properties":{"maximumPageSize":{"type":"integer"},"maximumScheduleRangeDays":{"type":"integer"},"rateLimitPerMinute":{"type":"integer"}},"required":["maximumPageSize","maximumScheduleRangeDays","rateLimitPerMinute"]}},"required":["authentication","keyId","userId","organizationId","access","capabilities","limits"]},"Market":{"type":"object","properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"name":{"type":"string"},"countryCode":{"type":"string","minLength":2,"maxLength":2},"timeZone":{"type":"string"},"latitude":{"type":"number","nullable":true,"minimum":-90,"maximum":90},"longitude":{"type":"number","nullable":true,"minimum":-180,"maximum":180},"profile":{"$ref":"#/components/schemas/MarketProfile"}},"required":["id","name","countryCode","timeZone","latitude","longitude","profile"]},"MarketProfile":{"type":"object","nullable":true,"properties":{"effectiveDate":{"type":"string","format":"date"},"population":{"type":"integer","minimum":0},"age0To14":{"type":"integer","minimum":0},"age15To24":{"type":"integer","minimum":0},"age25To44":{"type":"integer","minimum":0},"age45To64":{"type":"integer","minimum":0},"age65Plus":{"type":"integer","minimum":0}},"required":["effectiveDate","population","age0To14","age15To24","age25To44","age45To64","age65Plus"]},"Operator":{"type":"object","properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"name":{"type":"string"},"type":{"type":"string","nullable":true,"enum":["commercial_chain","independent","municipal","cultural",null]}},"required":["id","name","type"]},"Venue":{"type":"object","properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"name":{"type":"string"},"programmingType":{"type":"string","enum":["mainstream","mixed","specialist"]},"address":{"type":"string","nullable":true},"latitude":{"type":"number","nullable":true,"minimum":-90,"maximum":90},"longitude":{"type":"number","nullable":true,"minimum":-180,"maximum":180},"market":{"type":"object","properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"name":{"type":"string"},"countryCode":{"type":"string","minLength":2,"maxLength":2},"timeZone":{"type":"string"}},"required":["id","name","countryCode","timeZone"]},"operatorId":{"type":"string","nullable":true,"pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"}},"required":["id","name","programmingType","address","latitude","longitude","market","operatorId"]},"Auditorium":{"type":"object","properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"venueId":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"name":{"type":"string"},"capacity":{"type":"integer","nullable":true,"minimum":0,"exclusiveMinimum":true},"experiences":{"type":"array","nullable":true,"items":{"type":"string","enum":["imax","4dx","mx4d","dolby_atmos","4k","laser","direct_view","vip"]}}},"required":["id","venueId","name","capacity","experiences"]},"Distributor":{"type":"object","properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"name":{"type":"string"},"countryCode":{"type":"string","minLength":2,"maxLength":2}},"required":["id","name","countryCode"]},"MarketRelease":{"type":"object","properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"movieId":{"type":"string","nullable":true,"pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"countryCode":{"type":"string","minLength":2,"maxLength":2},"localTitle":{"type":"string"},"releaseDate":{"type":"string","nullable":true,"format":"date"},"distributorIds":{"type":"array","items":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"}}},"required":["id","movieId","countryCode","localTitle","releaseDate","distributorIds"]},"Release":{"type":"object","properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"movieId":{"type":"string","nullable":true,"pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"countryCode":{"type":"string","minLength":2,"maxLength":2},"scope":{"type":"string","enum":["current","archived"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","movieId","countryCode","scope","createdAt"]},"Showing":{"type":"object","properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"releaseId":{"type":"string","nullable":true,"pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"status":{"type":"string","enum":["scheduled","unlisted","cancelled"]},"startsAt":{"type":"string","format":"date-time"},"localDate":{"type":"string","format":"date"},"timeZone":{"type":"string"},"venue":{"type":"object","properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"name":{"type":"string"},"programmingType":{"type":"string","enum":["mainstream","mixed","specialist"]},"market":{"type":"object","properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"name":{"type":"string"},"countryCode":{"type":"string","minLength":2,"maxLength":2},"timeZone":{"type":"string"}},"required":["id","name","countryCode","timeZone"]}},"required":["id","name","programmingType","market"]},"auditorium":{"type":"object","nullable":true,"properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"name":{"type":"string"},"capacity":{"type":"integer","nullable":true,"minimum":0,"exclusiveMinimum":true},"experiences":{"type":"array","nullable":true,"items":{"type":"string","enum":["imax","4dx","mx4d","dolby_atmos","4k","laser","direct_view","vip"]}}},"required":["id","name","capacity","experiences"]},"movie":{"type":"object","properties":{"canonicalMovie":{"type":"object","nullable":true,"properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"title":{"type":"string"},"originalTitle":{"type":"string","nullable":true},"releaseYear":{"type":"integer","nullable":true},"runtimeMinutes":{"type":"integer","nullable":true,"minimum":0}},"required":["id","title","originalTitle","releaseYear","runtimeMinutes"]},"sourceTitle":{"type":"string"},"sourceOriginalTitle":{"type":"string","nullable":true},"identityStatus":{"type":"string","enum":["canonical","source"]}},"required":["canonicalMovie","sourceTitle","sourceOriginalTitle","identityStatus"]},"format":{"type":"string","enum":["2d","3d"]},"experiences":{"type":"array","items":{"type":"string","enum":["imax","4dx","mx4d","dolby_atmos","4k","laser","direct_view","vip"]}},"experienceSource":{"type":"string","nullable":true,"enum":["showing","auditorium",null]},"language":{"type":"string","nullable":true},"capacity":{"type":"integer","nullable":true,"minimum":0,"exclusiveMinimum":true},"capacitySource":{"type":"string","nullable":true,"enum":["showing","observation","auditorium",null]},"price":{"$ref":"#/components/schemas/ShowingPrice"},"seatAvailability":{"$ref":"#/components/schemas/SeatAvailability"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","releaseId","status","startsAt","localDate","timeZone","venue","auditorium","movie","format","experiences","experienceSource","language","capacity","capacitySource","price","seatAvailability","updatedAt"]},"ShowingPrice":{"type":"object","properties":{"status":{"type":"string","enum":["exact","derived","unavailable"]},"amountMinor":{"type":"integer","nullable":true,"minimum":0},"currency":{"type":"string","nullable":true,"minLength":3,"maxLength":3},"source":{"type":"string","nullable":true,"enum":["providerSchedule","providerBooking","officialTariff","legacyUnknown",null]},"observedAt":{"type":"string","nullable":true,"format":"date-time"},"lastConfirmedAt":{"type":"string","nullable":true,"format":"date-time"},"options":{"type":"array","items":{"type":"object","properties":{"offerKey":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"label":{"type":"string"},"amountMinor":{"type":"integer","minimum":0},"currency":{"type":"string","minLength":3,"maxLength":3},"admissionsIncluded":{"type":"integer","minimum":0,"exclusiveMinimum":true}},"required":["offerKey","label","amountMinor","currency","admissionsIncluded"]},"default":[]}},"required":["status","amountMinor","currency","source","observedAt","lastConfirmedAt"]},"SeatAvailability":{"type":"object","nullable":true,"properties":{"status":{"type":"string","enum":["exact","derived","unavailable"]},"observedAt":{"type":"string","format":"date-time"},"checkpoint":{"type":"string"},"capacity":{"type":"integer","nullable":true,"minimum":0},"availableSeats":{"type":"integer","nullable":true,"minimum":0},"occupiedEstimate":{"type":"integer","nullable":true,"minimum":0},"occupancyRatio":{"type":"number","nullable":true,"minimum":0,"maximum":1}},"required":["status","observedAt","checkpoint","capacity","availableSeats","occupiedEstimate","occupancyRatio"]},"Movie":{"type":"object","properties":{"id":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"title":{"type":"string"},"originalTitle":{"type":"string","nullable":true},"releaseYear":{"type":"integer","nullable":true},"runtimeMinutes":{"type":"integer","nullable":true,"minimum":0},"externalIds":{"type":"object","additionalProperties":{"type":"string"}},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","title","originalTitle","releaseYear","runtimeMinutes","externalIds","updatedAt"]},"AvailabilitySnapshot":{"allOf":[{"$ref":"#/components/schemas/SeatAvailability"},{"type":"object","properties":{"plannedAt":{"type":"string","format":"date-time"},"scheduledStartAt":{"type":"string","format":"date-time"}},"required":["plannedAt","scheduledStartAt"]}]}},"parameters":{}},"paths":{"/health":{"get":{"security":[],"responses":{"200":{"description":"Process liveness; does not check dependencies or public access","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"service":{"type":"string","enum":["box-observer-api"]}},"required":["ok","service"]}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_health","tags":["service"],"summary":"Process liveness; does not check dependencies or public access"}},"/ready":{"get":{"security":[],"responses":{"200":{"description":"The API and its data dependencies are ready to serve requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Readiness"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_ready","tags":["service"],"summary":"The API and its data dependencies are ready to serve requests"}},"/v1/account":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"responses":{"200":{"description":"Current authenticated access","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AuthenticatedAccount"},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_account","tags":["account"],"summary":"Current authenticated access"}},"/v1/markets":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2048},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional two-letter country filter. This narrows results; it does not grant access."},"required":false,"description":"Optional two-letter country filter. This narrows results; it does not grant access.","name":"countryCode","in":"query"}],"responses":{"200":{"description":"Cinema markets","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Market"}},"page":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","page","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_markets","tags":["markets"],"summary":"Cinema markets"}},"/v1/markets/{id}":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","minLength":5,"maxLength":256},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Cinema market","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Market"},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_markets_by_id","tags":["markets"],"summary":"Cinema market"}},"/v1/operators":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2048},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional two-letter country filter. This narrows results; it does not grant access."},"required":false,"description":"Optional two-letter country filter. This narrows results; it does not grant access.","name":"countryCode","in":"query"}],"responses":{"200":{"description":"Operators","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Operator"}},"page":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","page","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_operators","tags":["operators"],"summary":"Operators"}},"/v1/operators/{id}":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","minLength":5,"maxLength":256},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Operator","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Operator"},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_operators_by_id","tags":["operators"],"summary":"Operator"}},"/v1/venues":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2048},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional two-letter country filter. This narrows results; it does not grant access."},"required":false,"description":"Optional two-letter country filter. This narrows results; it does not grant access.","name":"countryCode","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"marketId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"operatorId","in":"query"}],"responses":{"200":{"description":"Physical cinema venues","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Venue"}},"page":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","page","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_venues","tags":["venues"],"summary":"Physical cinema venues"}},"/v1/venues/{id}":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","minLength":5,"maxLength":256},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Physical cinema venue","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Venue"},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_venues_by_id","tags":["venues"],"summary":"Physical cinema venue"}},"/v1/venues/{id}/auditoriums":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","minLength":5,"maxLength":256},"required":true,"name":"id","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2048},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"Venue auditoriums","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Auditorium"}},"page":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","page","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_venues_by_id_auditoriums","tags":["venues"],"summary":"Venue auditoriums"}},"/v1/distributors":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2048},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional two-letter country filter. This narrows results; it does not grant access."},"required":false,"description":"Optional two-letter country filter. This narrows results; it does not grant access.","name":"countryCode","in":"query"}],"responses":{"200":{"description":"Theatrical distributors","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Distributor"}},"page":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","page","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_distributors","tags":["distributors"],"summary":"Theatrical distributors"}},"/v1/distributors/{id}":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","minLength":5,"maxLength":256},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Distributor","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Distributor"},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_distributors_by_id","tags":["distributors"],"summary":"Distributor"}},"/v1/market-releases":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2048},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["current","archived","all"],"description":"Defaults to current (D1-owned). Archived selects published history; all explicitly combines both. Ownership is independent of Showing or premiere dates. Archived/all requires history:read."},"required":false,"description":"Defaults to current (D1-owned). Archived selects published history; all explicitly combines both. Ownership is independent of Showing or premiere dates. Archived/all requires history:read.","name":"scope","in":"query"},{"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional two-letter country filter. This narrows results; it does not grant access."},"required":false,"description":"Optional two-letter country filter. This narrows results; it does not grant access.","name":"countryCode","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"distributorId","in":"query"},{"schema":{"type":"string","format":"date"},"required":false,"name":"releasesFrom","in":"query"},{"schema":{"type":"string","format":"date"},"required":false,"name":"releasesBefore","in":"query"}],"responses":{"200":{"description":"Theatrical market releases","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MarketRelease"}},"page":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","page","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_market_releases","tags":["market-releases"],"summary":"Theatrical market releases"}},"/v1/market-releases/{id}":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","minLength":5,"maxLength":256},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Theatrical market release","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/MarketRelease"},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_market_releases_by_id","tags":["market-releases"],"summary":"Theatrical market release"}},"/v1/releases":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2048},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional two-letter country filter. This narrows results; it does not grant access."},"required":false,"description":"Optional two-letter country filter. This narrows results; it does not grant access.","name":"countryCode","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"movieId","in":"query"},{"schema":{"type":"string","enum":["current","archived","all"],"description":"Defaults to current (D1-owned). Archived selects published history; all explicitly combines both. Ownership is independent of Showing or premiere dates. Archived/all requires history:read."},"required":false,"description":"Defaults to current (D1-owned). Archived selects published history; all explicitly combines both. Ownership is independent of Showing or premiere dates. Archived/all requires history:read.","name":"scope","in":"query"}],"responses":{"200":{"description":"Country Releases with explicit ownership scope","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Release"}},"page":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","page","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_releases","tags":["releases"],"summary":"Country Releases with explicit ownership scope"}},"/v1/releases/{id}":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","minLength":5,"maxLength":256},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Stable country Release; its URL survives archival","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Release"},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_releases_by_id","tags":["releases"],"summary":"Stable country Release; its URL survives archival"}},"/v1/releases/{id}/showings":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","minLength":5,"maxLength":256},"required":true,"name":"id","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2048},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"venueId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"movieId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"operatorId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"marketId","in":"query"},{"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional two-letter country filter. This narrows results; it does not grant access."},"required":false,"description":"Optional two-letter country filter. This narrows results; it does not grant access.","name":"countryCode","in":"query"},{"schema":{"type":"string","format":"date"},"required":false,"name":"localDate","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"startsFrom","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"startsBefore","in":"query"}],"responses":{"200":{"description":"Showings of one Release, automatically read from its authoritative owner","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Showing"}},"page":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","page","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_releases_by_id_showings","tags":["releases"],"summary":"Showings of one Release, automatically read from its authoritative owner"}},"/v1/movies":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2048},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":160},"required":false,"name":"query","in":"query"},{"schema":{"type":"integer","minimum":1880,"maximum":2200},"required":false,"name":"releaseYear","in":"query"}],"responses":{"200":{"description":"Canonical movies","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Movie"}},"page":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","page","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_movies","tags":["movies"],"summary":"Canonical movies"}},"/v1/movies/{id}":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","minLength":5,"maxLength":256},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Canonical movie","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Movie"},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_movies_by_id","tags":["movies"],"summary":"Canonical movie"}},"/v1/showings":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2048},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["current","archived","all"],"description":"Defaults to current (D1-owned). Archived selects published history; all explicitly combines both. Ownership is independent of Showing or premiere dates. Archived/all requires history:read."},"required":false,"description":"Defaults to current (D1-owned). Archived selects published history; all explicitly combines both. Ownership is independent of Showing or premiere dates. Archived/all requires history:read.","name":"scope","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"releaseId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"venueId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"movieId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"operatorId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"marketId","in":"query"},{"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional two-letter country filter. This narrows results; it does not grant access."},"required":false,"description":"Optional two-letter country filter. This narrows results; it does not grant access.","name":"countryCode","in":"query"},{"schema":{"type":"string","format":"date"},"required":false,"name":"localDate","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"startsFrom","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"startsBefore","in":"query"}],"responses":{"200":{"description":"Showings","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Showing"}},"page":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","page","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_showings","tags":["showings"],"summary":"Showings"}},"/v1/venues/{id}/showings":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","minLength":5,"maxLength":256},"required":true,"name":"id","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2048},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["current","archived","all"],"description":"Defaults to current (D1-owned). Archived selects published history; all explicitly combines both. Ownership is independent of Showing or premiere dates. Archived/all requires history:read."},"required":false,"description":"Defaults to current (D1-owned). Archived selects published history; all explicitly combines both. Ownership is independent of Showing or premiere dates. Archived/all requires history:read.","name":"scope","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"releaseId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"movieId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"operatorId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"marketId","in":"query"},{"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional two-letter country filter. This narrows results; it does not grant access."},"required":false,"description":"Optional two-letter country filter. This narrows results; it does not grant access.","name":"countryCode","in":"query"},{"schema":{"type":"string","format":"date"},"required":false,"name":"localDate","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"startsFrom","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"startsBefore","in":"query"}],"responses":{"200":{"description":"Venue showings","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Showing"}},"page":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","page","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_venues_by_id_showings","tags":["venues"],"summary":"Venue showings"}},"/v1/movies/{id}/showings":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","minLength":5,"maxLength":256},"required":true,"name":"id","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2048},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["current","archived","all"],"description":"Defaults to current (D1-owned). Archived selects published history; all explicitly combines both. Ownership is independent of Showing or premiere dates. Archived/all requires history:read."},"required":false,"description":"Defaults to current (D1-owned). Archived selects published history; all explicitly combines both. Ownership is independent of Showing or premiere dates. Archived/all requires history:read.","name":"scope","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"releaseId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"venueId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"operatorId","in":"query"},{"schema":{"type":"string","pattern":"^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$"},"required":false,"name":"marketId","in":"query"},{"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional two-letter country filter. This narrows results; it does not grant access."},"required":false,"description":"Optional two-letter country filter. This narrows results; it does not grant access.","name":"countryCode","in":"query"},{"schema":{"type":"string","format":"date"},"required":false,"name":"localDate","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"startsFrom","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"startsBefore","in":"query"}],"responses":{"200":{"description":"Movie showings","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Showing"}},"page":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","page","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_movies_by_id_showings","tags":["movies"],"summary":"Movie showings"}},"/v1/showings/{id}":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","minLength":5,"maxLength":256},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Showing","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Showing"},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_showings_by_id","tags":["showings"],"summary":"Showing"}},"/v1/showings/{id}/availability":{"get":{"security":[{"ClerkSession":[]},{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","minLength":5,"maxLength":256},"required":true,"name":"id","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":2048},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"Showing availability history","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AvailabilitySnapshot"}},"page":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]},"meta":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"required":["requestId","generatedAt"]}},"required":["data","page","meta"]}}}},"400":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request rejected","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service unavailable or public access temporarily disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"operationId":"get_v1_showings_by_id_availability","tags":["showings"],"summary":"Showing availability history"}}}}