Skip to main content
GET
/
roles
/
{id}
Get Role
curl --request GET \
  --url https://api.example.com/roles/{id}
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "production_id": "<string>"
}

​
Overview

Returns detailed information about a single role/character identified by its unique ID.

​
Path Parameters

​
id
string
required
The unique identifier of the role

​
Request

curl https://entertheatre.com/api/roles/role-001

​
Response

​
id
string
required
Unique identifier for the role
​
name
string
required
Name of the character/role
​
description
string
Description of the character
​
production_id
string
required
ID of the production this role belongs to

​
Example Response

{
  "id": "role-001",
  "name": "Grizabella",
  "description": "The glamour cat who sings 'Memory'. Once a glamorous cat who left the Jellicle tribe to explore the world, she returns old, disheveled, and rejected by her former friends.",
  "production_id": "prod-005"
}

​
Error Response

{
  "error": "Role not found"
}

​
Status Codes

StatusDescription
200Success - returns role object
404Role not found
500Server error