Skip to main content

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

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

Common Use Cases

curl https://entertheatre.com/api/theatres
The response includes venue details and currently running productions.
curl https://entertheatre.com/api/cast-members?production_id=xyz789
Returns all cast members with their roles and billing order.
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