Get countries
GET/countries
Get every country the API serves, and whether your key includes it. Without a country parameter, every other endpoint reads the countries your key includes.
Response
200 Returns the countries served. (CountriesResponse)
Errors: 400, 401, 403, 429, 500
400Bad 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.401Unauthorized – the request requires valid authentication.403Forbidden – authentication succeeded but access is denied (e.g., expired subscription, or a country your key does not include).429Too Many Requests – the limit is 5 requests per second for a Pro account. An account with Ultra in one or more countries has 20. An account with Lite in all its countries has 1, and 1000 requests each day. The day starts at 00:00 UTC. All the keys of an account share the limit. The limit is not for each country. The error message gives the limit that applied.500Internal Server Error – something went wrong on our end.
curl -H "Authorization: Bearer YOUR_API_TOKEN" "https://api.showtimes-api.com/v4/countries"
const response = await fetch("https://api.showtimes-api.com/v4/countries", {
headers: { Authorization: "Bearer YOUR_API_TOKEN" },
})
const body = await response.json()
import requests
response = requests.get(
"https://api.showtimes-api.com/v4/countries",
headers={"Authorization": "Bearer YOUR_API_TOKEN"},
)
body = response.json()
require "json"
require "net/http"
response = Net::HTTP.get_response(
URI("https://api.showtimes-api.com/v4/countries"),
{"Authorization" => "Bearer YOUR_API_TOKEN"}
)
body = JSON.parse(response.body)
{
"meta": {
"total_count": 2
},
"data": [
{
"iso_code": "GB",
"name": "United Kingdom",
"is_access_granted": true,
"tier": "ultra"
},
{
"iso_code": "IE",
"name": "Ireland",
"is_access_granted": false,
"tier": null
}
]
}