List Avatars

GET

https://api.zebracat.ai/v1/avatars

Avatars

Returns a paginated list of all available avatars.

Filtering by type:

?mode=video — AI video avatars (system-provided)

?mode=custom — Custom avatars uploaded by the authenticated user

Results include avatar metadata such as preview images, gender, age, style, and source files.

Request

Authorization

API Key

Add parameter in header

X-API-KEY

Example:

X-API-KEY: ********************

Query Params

Responses

🟢200

application/json

Body

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.zebracat.ai/v1/avatars?page&page_size&mode&id' \
--header 'X-API-KEY: <api-key>'

Response Example

200 - Example 1

[
    {
        "id": 0,
        "preview": "string",
        "video_preview": "string",
        "status": "string",
        "overlay": "string",
        "name": "string",
        "gender": "string",
        "age": "string",
        "style": "string",
        "mode": "string",
        "category": "string",
        "used_for_new_user_flow": false,
        "suggested_voice_id": "string",
        "is_favorite": false,
        "srcs": "string",
        "noisy_overlay": "string",
        "face_detection_issue": false,
        "is_custom": false,
        "is_ugc": false
    }
]

Get Usage Detail

List Brands