Attributes endpoints | UK Cinema API

Get showtime attributes

GET/attributes

Get all available showtime attribute codes with their descriptions and categories.

Response

200 Returns all available showtime attributes. (AttributesResponse)

Errors: 400, 401, 403, 429, 500

400 Bad request – e.g. an invalid cursor, a country the API does not serve, a filter that is not valid, or a query parameter that the endpoint does not have. The message names the parameter.
401 Unauthorized – the request requires valid authentication.
403 Forbidden – authentication succeeded but access is denied (e.g., expired subscription, or a country your key does not include).
429 Too Many Requests – the limit is 5 requests per second for a Pro key. A key with Ultra in one or more countries has 20. A key with Lite in all its countries has 1, and 1000 requests each day. The day starts at 00:00 UTC. The limit is for the key, not for each country. The error message gives the limit that applied.
500 Internal Server Error – something went wrong on our end.

const response = await fetch("https://uk-cinema-api.co.uk/api/v4/attributes", {
  headers: { Authorization: "Bearer YOUR_API_TOKEN" },
})
const body = await response.json()

import requests

response = requests.get(
    "https://uk-cinema-api.co.uk/api/v4/attributes",
    headers={"Authorization": "Bearer YOUR_API_TOKEN"},
)
body = response.json()

require "json"
require "net/http"

response = Net::HTTP.get_response(
  URI("https://uk-cinema-api.co.uk/api/v4/attributes"),
  {"Authorization" => "Bearer YOUR_API_TOKEN"}
)
body = JSON.parse(response.body)

Example response

{
  "meta": {
    "total_count": 43
  },
  "data": [
    {
      "id": "imax",
      "title": "IMAX",
      "description": "Large-format IMAX presentation",
      "category": "format"
    }
  ]
}