curl "https://api.hooked.so/v1/character/cm4xa1b2c0001cd34ef56gh78" \
  -H "x-api-key: your_api_key_here"

const response = await fetch("https://api.hooked.so/v1/character/cm4xa1b2c0001cd34ef56gh78", {
  headers: { "x-api-key": process.env.HOOKED_API_KEY },
});
const { data: character } = await response.json();

import os
import requests

response = requests.get(
    "https://api.hooked.so/v1/character/cm4xa1b2c0001cd34ef56gh78",
    headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
)
character = response.json()["data"]

{
  "success": true,
  "message": "Character fetched successfully",
  "data": {
    "id": "cm4xa1b2c0001cd34ef56gh78",
    "name": "Mia",
    "description": "Late 20s, red curly hair, denim jacket",
    "voiceProfile": "Warm, slightly husky, speaks fast",
    "presetId": "cinematic",
    "imageUrl": "https://files.hooked.so/team/public/mia--fid--1a2b.png",
    "imageStatus": "COMPLETED",
    "createdAt": "2026-09-30T18:00:00.000Z"
  }
}

{
  "success": false,
  "message": "Character not found"
}