# List Characters

`GET /v1/characters`

Your saved characters, newest first.

Base URL: `https://api.spicyapi.com`

## Authorizations

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

## Request

```bash
curl --request GET \
  --url https://api.spicyapi.com/v1/characters \
  --header 'Authorization: Bearer $SPICYAPI_KEY'
```

## Response: 200 application/json

Successful Response

- `data` (Character · object[], required): Characters, newest first.

```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": "…", "imported": false, "status": "active", "created": 1758553200 }
  ]
}
```