Get a film
GET
/v1/films/{filmId}Authorization
AuthorizationBearer token · headerrequiredAn Unkey API key verified at the Gateway.
Path parameters
filmIdstringrequiredResponses
200A single result with source freshness.
dataobjectrequiredShow propertiesHide properties
idstringrequiredmin length 1 · max length 160
titlestringrequiredmin length 1 · max length 300
durationMinutesintegermax 1000
certificationstringmin length 1 · max length 32
posterUrlstring<uri>releaseDatestring<date>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])))$
provenanceobjectrequiredShow propertiesHide properties
observedAtstring<date-time>requiredmatches ^(?:(?:\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)))$
providerstringrequiredmin length 1 · max length 80
externalIdstringrequiredmin length 1 · max length 240
freshnessobjectrequiredShow propertiesHide properties
observedAtstring<date-time>requiredmatches ^(?:(?:\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.
errorobjectrequiredShow propertiesHide properties
codestringrequiredAllowed:
bad_requestdatabase_unavailableentitlement_requiredforbiddeninternal_errornot_foundrate_limitedunauthorizedmessagestringrequiredmin length 1 · max length 300
requestIdstringmin length 1 · max length 160
detailsobject401Rejected by Unkey Gateway before reaching the application.
errorobjectrequiredShow propertiesHide properties
codestringrequiredAllowed:
bad_requestdatabase_unavailableentitlement_requiredforbiddeninternal_errornot_foundrate_limitedunauthorizedmessagestringrequiredmin length 1 · max length 300
requestIdstringmin length 1 · max length 160
detailsobject403The organization does not have an active paid entitlement.
errorobjectrequiredShow propertiesHide properties
codestringrequiredAllowed:
bad_requestdatabase_unavailableentitlement_requiredforbiddeninternal_errornot_foundrate_limitedunauthorizedmessagestringrequiredmin length 1 · max length 300
requestIdstringmin length 1 · max length 160
detailsobject404The requested resource was not found.
errorobjectrequiredShow propertiesHide properties
codestringrequiredAllowed:
bad_requestdatabase_unavailableentitlement_requiredforbiddeninternal_errornot_foundrate_limitedunauthorizedmessagestringrequiredmin length 1 · max length 300
requestIdstringmin length 1 · max length 160
detailsobject429Rate limited by Unkey Gateway before reaching the application.
errorobjectrequiredShow propertiesHide properties
codestringrequiredAllowed:
bad_requestdatabase_unavailableentitlement_requiredforbiddeninternal_errornot_foundrate_limitedunauthorizedmessagestringrequiredmin length 1 · max length 300
requestIdstringmin length 1 · max length 160
detailsobject500An unexpected application error occurred.
errorobjectrequiredShow propertiesHide properties
codestringrequiredAllowed:
bad_requestdatabase_unavailableentitlement_requiredforbiddeninternal_errornot_foundrate_limitedunauthorizedmessagestringrequiredmin length 1 · max length 300
requestIdstringmin length 1 · max length 160
detailsobject503The application or database is temporarily unavailable.
errorobjectrequiredShow propertiesHide properties
codestringrequiredAllowed:
bad_requestdatabase_unavailableentitlement_requiredforbiddeninternal_errornot_foundrate_limitedunauthorizedmessagestringrequiredmin length 1 · max length 300
requestIdstringmin length 1 · max length 160
detailsobjectRequest
curl -X GET "https://api.cinemadata.uk/v1/films/string" \
-H "Authorization: Bearer YOUR_TOKEN"const response = await fetch("https://api.cinemadata.uk/v1/films/string", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_TOKEN"
}
});import requests
response = requests.get(
"https://api.cinemadata.uk/v1/films/string",
headers={
"Authorization": "Bearer YOUR_TOKEN"
},
)Response
{
"data": {
"id": "string",
"title": "string",
"durationMinutes": 0,
"certification": "string",
"posterUrl": "<uri>",
"releaseDate": "<date>",
"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"
}
}{
"error": {
"code": "bad_request",
"message": "string",
"requestId": "string",
"details": {}
}
}{
"error": {
"code": "bad_request",
"message": "string",
"requestId": "string",
"details": {}
}
}{
"error": {
"code": "bad_request",
"message": "string",
"requestId": "string",
"details": {}
}
}{
"error": {
"code": "bad_request",
"message": "string",
"requestId": "string",
"details": {}
}
}{
"error": {
"code": "bad_request",
"message": "string",
"requestId": "string",
"details": {}
}
}{
"error": {
"code": "bad_request",
"message": "string",
"requestId": "string",
"details": {}
}
}{
"error": {
"code": "bad_request",
"message": "string",
"requestId": "string",
"details": {}
}
}