{ "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" } } } }