List Characters

Retrieve paginated Prism characters visible to your API key, including public characters and private characters owned by the authenticated user.

GET /api/characters

Returns a paginated list of characters visible to the API key owner:

• Public characters (isPublic: true)
• Private characters owned by the same API key user

Query parameters

Parameter	Type	Default	Description
q	string	—	Optional case-insensitive search across character name (min 2 chars)
limit	integer	24	Number of characters to return (max 60)
offset	integer	0	Pagination offset

Request

curl "https://www.prismvideos.com/api/characters?limit=10&q=comedian" \
  -H "Authorization: Bearer prism_sk_your_key_here"

Response

{
  "data": [
    {
      "id": "d2a7e0d5-1705-43b5-be96-85b9c5f25b80",
      "name": "Rajit Khanna",
      "description": "the cutest little guy in the world",
      "created_at": 1773361092291
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 10,
    "has_more": false
  }
}

Response fields

Character object

Field	Type	Description
id	string	Unique character identifier
name	string	Character name
description	string or null	Character description
created_at	number or null	Unix timestamp in milliseconds

Pagination object

Field	Type	Description
offset	number	Current offset
limit	number	Requested limit
has_more	boolean	Whether more results exist beyond this page

Errors

Status	Error	When
400	validation_error	q is present but shorter than 2 characters
401	unauthorized	Missing or invalid API key
500	server_error	Unexpected server error while listing characters

See Errors for the full error reference.