Quickstart - Enter Theatre API

Make Your First Request

Get up and running with the Enter Theatre API in under a minute.

Step 1: Choose an Endpoint

The simplest way to start is by fetching the list of all shows:

curl https://entertheatre.com/api/shows

const response = await fetch('https://entertheatre.com/api/shows');
const shows = await response.json();
console.log(shows);

import requests

response = requests.get('https://entertheatre.com/api/shows')
shows = response.json()
print(shows)

Step 2: Explore the Response

You’ll receive an array of show objects:

[
  {
    "id": "abc123",
    "name": "The Phantom of the Opera",
    "type": "musical",
    "description": "Andrew Lloyd Webber's legendary musical...",
    "image": "https://example.com/phantom.jpg",
    "booking_until": "2025-06-30"
  },
  {
    "id": "def456",
    "name": "Hamilton",
    "type": "musical",
    "description": "The story of America's founding father...",
    "image": "https://example.com/hamilton.jpg",
    "booking_until": "2025-12-31"
  }
]

Step 3: Get More Details

Fetch a specific show by ID:

curl https://entertheatre.com/api/shows/abc123

const response = await fetch('https://entertheatre.com/api/shows/abc123');
const show = await response.json();
console.log(show);

import requests

response = requests.get('https://entertheatre.com/api/shows/abc123')
show = response.json()
print(show)

Common Use Cases

List all theatres with their current shows

curl https://entertheatre.com/api/theatres

The response includes venue details and currently running productions.

Get cast members for a specific production

curl https://entertheatre.com/api/cast-members?production_id=xyz789

Returns all cast members with their roles and billing order.

Find productions at a specific theatre

curl https://entertheatre.com/api/productions?theatre_id=theatre123

Filter productions by theatre venue.

Rate Limits

The public API is limited to 100 requests per day per IP address. For production use, get an API key for 10,000 requests per day:

curl https://entertheatre.com/api/shows \
  -H "Authorization: Bearer et_your_api_key"

Get your API key at entertheatre.com/dashboard/api-keys.

Next Steps

API Reference

Explore the complete API documentation.

Authentication

Get an API key for higher rate limits.

​Make Your First Request

​Step 1: Choose an Endpoint

​Step 2: Explore the Response

​Step 3: Get More Details

​Common Use Cases

​Rate Limits

​Next Steps