For Your Show for developers

For Your Show has a read-only API and an MCP server for the theatre companies, shows and auditions published on the site. Everything they return is already visible to a signed-out visitor, so neither needs a key or an account.

REST API

The base address is https://foryourshow.com/api/v1. Responses are JSON, with dates in ISO 8601 and names in camelCase. Each result carries a url you can follow to its full record. Lists return 12 results a page; add ?page=2 for the next.

Requests are limited to 60 a minute for each IP address. Go over it and you will get a 429 response; wait a moment and try again.

Endpoints

  • GET /companies Search published theatre companies. Filter with q, country and state.
  • GET /companies/{company} One company.
  • GET /companies/suggestions Company names for autocomplete, from two characters of q.
  • GET /shows Search published shows. Filter with q, genre, country, state and status (current, upcoming or past).
  • GET /shows/{show} One show.
  • GET /auditions Search public auditions. Filter with q, genre, country, state and status (open or upcoming).
  • GET /auditions/{audition} One audition.
  • GET /suburbs Suburb names for autocomplete. Filter with q, country and state.

The full description of every endpoint, its parameters and its responses, for code generators and API tools: OpenAPI description

MCP server

AI assistants that support the Model Context Protocol can search and read the same published companies and shows at https://foryourshow.com/mcp/public. It is read-only and limited to 30 requests a minute for each IP address.

Discovery

Programs can find all of this from the API catalog at https://foryourshow.com/.well-known/api-catalog, as described in RFC 9727. The service status is at https://foryourshow.com/up.

Questions, or something missing? Email [email protected].