Skip to content
CinemaData is in private beta.View access
CinemaData
Esc
↑↓navigate↵open⌘Jpreview

List showtimes

GET/v1/showtimes
Authorization
AuthorizationBearer token · headerrequired
An Unkey API key verified at the Gateway.
Query parameters
cursorstring
limitinteger
min 1 · max 100 · default: 25
cinemaIdstring
filmIdstring
startsAfterstring<date-time>
Responses
200A paginated result with source freshness.
dataobject[]required
Show properties
Array of object
idstringrequired
min length 1 · max length 160
filmIdstringrequired
min length 1 · max length 160
cinemaIdstringrequired
min length 1 · max length 160
startsAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
bookingUrlstring<uri>
attributeIdsstring[]required
max items 32
screenNamestring
min length 1 · max length 120
provenanceobjectrequired
Show properties
observedAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
sourceUpdatedAtstring<date-time>
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
providerstringrequired
min length 1 · max length 80
externalIdstringrequired
min length 1 · max length 240
paginationobjectrequired
Show properties
nextCursorstring | anyrequired
Show properties
Any of:
string
string
any
any
hasMorebooleanrequired
freshnessobjectrequired
Show properties
observedAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
sourceUpdatedAtstring<date-time>
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
400The request failed application validation.
errorobjectrequired
Show properties
codestringrequired
Allowed:bad_requestdatabase_unavailableentitlement_requiredforbiddeninternal_errornot_foundrate_limitedunauthorized
messagestringrequired
min length 1 · max length 300
requestIdstring
min length 1 · max length 160
detailsobject
401Rejected by Unkey Gateway before reaching the application.
errorobjectrequired
Show properties
codestringrequired
Allowed:bad_requestdatabase_unavailableentitlement_requiredforbiddeninternal_errornot_foundrate_limitedunauthorized
messagestringrequired
min length 1 · max length 300
requestIdstring
min length 1 · max length 160
detailsobject
403The organization does not have an active paid entitlement.
errorobjectrequired
Show properties
codestringrequired
Allowed:bad_requestdatabase_unavailableentitlement_requiredforbiddeninternal_errornot_foundrate_limitedunauthorized
messagestringrequired
min length 1 · max length 300
requestIdstring
min length 1 · max length 160
detailsobject
429Rate limited by Unkey Gateway before reaching the application.
errorobjectrequired
Show properties
codestringrequired
Allowed:bad_requestdatabase_unavailableentitlement_requiredforbiddeninternal_errornot_foundrate_limitedunauthorized
messagestringrequired
min length 1 · max length 300
requestIdstring
min length 1 · max length 160
detailsobject
500An unexpected application error occurred.
errorobjectrequired
Show properties
codestringrequired
Allowed:bad_requestdatabase_unavailableentitlement_requiredforbiddeninternal_errornot_foundrate_limitedunauthorized
messagestringrequired
min length 1 · max length 300
requestIdstring
min length 1 · max length 160
detailsobject
503The application or database is temporarily unavailable.
errorobjectrequired
Show properties
codestringrequired
Allowed:bad_requestdatabase_unavailableentitlement_requiredforbiddeninternal_errornot_foundrate_limitedunauthorized
messagestringrequired
min length 1 · max length 300
requestIdstring
min length 1 · max length 160
detailsobject
Request
curl -X GET "https://api.cinemadata.uk/v1/showtimes" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "data": [
    {
      "id": "string",
      "filmId": "string",
      "cinemaId": "string",
      "startsAt": "2024-01-01T00:00:00Z",
      "bookingUrl": "<uri>",
      "attributeIds": [
        "string"
      ],
      "screenName": "string",
      "provenance": {
        "observedAt": "2024-01-01T00:00:00Z",
        "sourceUpdatedAt": "2024-01-01T00:00:00Z",
        "provider": "string",
        "externalId": "string"
      }
    }
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  },
  "freshness": {
    "observedAt": "2024-01-01T00:00:00Z",
    "sourceUpdatedAt": "2024-01-01T00:00:00Z"
  }
}