curl -X GET "https://api.hooked.so/v1/avatar/list?type=library&limit=20" \
  -H "x-api-key: your_api_key_here"

const response = await fetch('https://api.hooked.so/v1/avatar/list?type=library&limit=20', {
  headers: { 'x-api-key': 'your_api_key_here' }
});

const { data } = await response.json();
console.log(data.total, data.avatars.map((a) => a.id));

import requests

response = requests.get(
    'https://api.hooked.so/v1/avatar/list',
    params={'type': 'library', 'limit': 20},
    headers={'x-api-key': 'your_api_key_here'}
)

avatars = response.json()['data']['avatars']

{
  "success": true,
  "data": {
    "avatars": [
      {
        "id": "1",
        "name": "Harper",
        "type": "AI",
        "gender": "Female",
        "age": "Young Adult",
        "image": "https://.../avatars/harper/thumbnail/harper.png",
        "isHD": true,
        "isPro": false,
        "isNew": true,
        "situation": ["couch"],
        "emotions": ["Calm", "Attentive"],
        "skinTone": "light",
        "isCustom": false,
        "source": "library"
      },
      {
        "id": "2",
        "name": "Emma",
        "type": "Realistic",
        "gender": "Female",
        "age": "Young Adult",
        "image": "https://.../avatars/emma/thumbnail/emma.png",
        "isHD": true,
        "isPro": false,
        "isNew": true,
        "situation": ["Kitchen"],
        "emotions": ["Calm"],
        "skinTone": "light",
        "isCustom": false,
        "source": "library"
      }
    ],
    "total": 83,
    "limit": 20,
    "offset": 0,
    "library": 83,
    "custom": 0
  }
}

{
  "code": "not_authenticated",
  "message": "Not authenticated",
  "errorCode": "NOT_AUTHENTICATED",
  "details": { "x-api-key": "Header not provided or API Key invalid" }
}