Overview Returns a list of all cast member assignments linking people to productions. Includes nested data for the person, production, and role. Optionally filter by person ID.
Query Parameters Filter cast members by person ID to see all their roles
Request # Get all cast members curl https://entertheatre.com/api/cast-members # Filter by person curl https://entertheatre.com/api/cast-members?person_id=person-001
Response Array of cast member objects Unique identifier for the cast member assignment
ID of the role/character (if applicable)
Type of role: principal, ensemble, understudy, swing, standby, alternate
Order in the billing (1 = top billing)
Nested person object with name, bio, and image
Nested production object with show details
Nested role object with character name
Example Response [ { "id" : "cast-001" , "person_id" : "person-001" , "production_id" : "prod-001" , "role_id" : "role-001" , "role_type" : "principal" , "billing_order" : 1 , "person" : { "id" : "person-001" , "name" : "Elaine Paige" , "bio" : "Legendary West End star..." , "image" : "https://example.com/elaine.jpg" }, "production" : { "id" : "prod-001" , "show" : { "name" : "Cats" , "type" : "musical" } }, "role" : { "id" : "role-001" , "name" : "Grizabella" } }, { "id" : "cast-002" , "person_id" : "person-002" , "production_id" : "prod-002" , "role_id" : "role-005" , "role_type" : "principal" , "billing_order" : 1 , "person" : { "id" : "person-002" , "name" : "Michael Ball" , "bio" : "Award-winning musical theatre actor..." , "image" : "https://example.com/michael.jpg" }, "production" : { "id" : "prod-002" , "show" : { "name" : "Les Miserables" , "type" : "musical" } }, "role" : { "id" : "role-005" , "name" : "Marius" } } ] Status Codes Status Description 200Success - returns array of cast members 500Server error
