Characters

List Characters

Your saved characters, newest first.

GET/v1/charactersTry it
List Characters
cURL
curl --request GET \
  --url https://api.spicyapi.com/v1/characters \
  --header 'Authorization: Bearer $SPICYAPI_KEY'
200
JSON
{
  "object": "list",
  "data": [
    { "id": "chr_9f2a1c3b7d4e5a60", "object": "character", "name": "Mara", "sheet_url": "https://cdn.spicyapi.com/outputs/a1b2/chr_9f2a1c3b7d4e5a60.png", "source_urls": ["…"], "description": "…", "created": 1758553200 }
  ]
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your SpicyAPI key (sk-spicy-…). Create one in the dashboard under API Keys.

Response

200 · application/json

Successful Response

dataCharacter · object[]required

Characters, newest first.

Was this page helpful?