Quick start

Make your first request to the CinemaData API.

1. Create an account

Sign in at cinemadata.uk with Google or a magic link. CinemaData creates one organization for your account.

2. Subscribe and create a key

Choose monthly or annual access, then create an API key from your organization dashboard. The secret is shown once. Store it in a secret manager rather than source control.

3. Request showtimes

curl "https://api.cinemadata.uk/v1/showtimes?cinemaId=YOUR_CINEMA_ID&startsAfter=2026-07-29T00%3A00%3A00Z&startsBefore=2026-07-30T00%3A00%3A00Z&limit=25" \
  --header "Authorization: Bearer cd_live_YOUR_API_KEY"

Showtime windows are required and may cover at most 31 days. To require screening features, pass canonical IDs such as attributeIds=imax,subtitled; a result must contain every requested attribute.

Successful collection responses include data, pagination, and freshness.

{
  "data": [],
  "pagination": {
    "hasMore": false,
    "nextCursor": null
  },
  "freshness": {
    "observedAt": "2026-07-28T09:00:00.000Z"
  }
}

Continue with the generated API reference.