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

Get a cinema

GET/v1/cinemas/{cinemaId}
Authorization
AuthorizationBearer token · headerrequired
An Unkey API key verified at the Gateway.
Path parameters
cinemaIdstringrequired
Responses
200A single result with source freshness.
dataobjectrequired
Show properties
idstringrequired
min length 1 · max length 160
chainIdstring
min length 1 · max length 160
namestringrequired
min length 1 · max length 240
locationobjectrequired
Show properties
countryCodestringrequired
localitystringrequired
min length 1 · max length 160
postcodestringrequired
min length 2 · max length 16
addressstring
min length 1 · max length 300
latitudenumber
min -90 · max 90
longitudenumber
min -180 · max 180
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
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
404The requested resource was not found.
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/cinemas/string" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "data": {
    "id": "string",
    "chainId": "string",
    "name": "string",
    "location": {
      "countryCode": "GB",
      "locality": "string",
      "postcode": "string",
      "address": "string",
      "latitude": 0,
      "longitude": 0
    },
    "provenance": {
      "observedAt": "2024-01-01T00:00:00Z",
      "sourceUpdatedAt": "2024-01-01T00:00:00Z",
      "provider": "string",
      "externalId": "string"
    }
  },
  "freshness": {
    "observedAt": "2024-01-01T00:00:00Z",
    "sourceUpdatedAt": "2024-01-01T00:00:00Z"
  }
}