Skip to main content
GET

Overview

This endpoint returns all avatars available to your account, including both the SlideVid library avatars and any custom avatars you’ve created.

Query Parameters

string
default:"all"
Filter avatars by type:
  • library: Only library avatars from SlideVid
  • custom: Only custom avatars created by your team
  • all: Both library and custom avatars (default)

Response

boolean
Indicates if the request was successful
object

Use Cases

While the API doesn’t support direct gender/age filtering, you can filter the results client-side:
Get only avatars that support HD quality:
Identify which avatars require a Pro subscription:

Notes

Custom avatars require processing time after creation. Only avatars with status: 2 (completed) are included in the list.
Cache avatar lists for better performance. Avatar libraries don’t change frequently, so you can safely cache this data for 24 hours.

Authorizations

x-api-key
string
header
required

Query Parameters

type
enum<string>
default:all

Filter by avatar type

Available options:
library,
custom,
all

Response

200

Success