Overview
The API contract, availability and where to start.
Use an organization API key or an active Box Observer session with an explicit API grant. Access is limited to your permitted datasets and markets. Read about access →
https://api.boxobserver.comStart here
Use the API to understand cinema entities, published schedules and the observations behind seat estimates. Start with the access model, then choose the resources you need.
Connecting an assistant? Use the MCP connection guide and tool reference for the same read-only data and access rules.
Resources
| Resource | What it contains |
|---|---|
| Markets | Cinema markets, geographic context and available population profiles. |
| Operators | Cinema operators and their classifications. |
| Venues & auditoriums | Physical cinemas, auditoriums and a cinema’s programme. |
| Distributors | Theatrical distributors in the available dataset. |
| Releases | Stable country runs, current/archive scope, and calendar announcements. |
| Movies | Canonical film identities and their published showings. |
| Showings & availability | Scheduled performances, published prices and seat observations. |
Check service health
Health endpoints are available without a token. Readiness checks the data and access schemas; it does not grant an account permission to read data.
curl https://api.boxobserver.com/healthOne contract, two formats
The endpoint reference and downloadable OpenAPI 3.0 document are generated from the same route definitions and schemas as the API. The reference includes 24 GET operations, including health and readiness.