Coverage & roadmap
What the API includes and what remains unavailable.
Read-only production API
The resources below are available to approved organizations, within their granted datasets and cinema markets.
Included in the contract
| Area | Coverage |
|---|---|
| Cinema directory | Markets and population profiles, operators, venues and auditoriums. |
| Film identity | Canonical identity, titles, release year, runtime and external identifiers. |
| Release calendar | Local titles, national release dates and distributors. |
| Published programme | Showing times, venue, room, formats, experiences and language. |
| Prices | Current published price and available offer options. |
| Seat observations | Latest confirmed availability and paginated observation history. |
| Service operations | Liveness, dependency readiness and an OpenAPI schema. |
Not exposed by this API
- Self-service key creation, OAuth client credentials and a billing quota API.
- The app’s portfolio totals, daily reports, competitor aggregates and booking-trend endpoints.
- Rich catalogue content such as posters, trailers, cast and production-company profiles.
- Price history, incremental change feeds, outbound webhooks and bulk exports.
- Ticket purchase, confirmed sales, attendance, revenue or programme editing.
Dataset boundary
The deployment currently reads the Romanian market database. The contract supports country filters; that does not imply that other countries are populated or licensed for access. Completeness varies by provider and resource.
Next priorities
- Integration workflow: self-service key management and usage reporting.
- Reporting: expose stable aggregate contracts only where the recorded data supports them.
- Scale: benchmark filtered schedules and catalogue search, then add selective indexes or search infrastructure.
These are priorities, not delivery-date commitments. The current API remains read-only.