Skip to main content
GET
list avatars

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
integer
default:1

Page number for pagination

Required range: x >= 1
perPage
integer
default:10

Number of avatars per page (max 100)

Required range: 1 <= x <= 100

Search term to filter avatars by display name or generated description

renderStyle
enum<string>
default:all

Filter avatars by render style. unknown includes avatars whose style has not been determined (all custom avatars, and any avatar whose metadata generation has not completed).

Available options:
all,
realistic,
animated_3d,
illustrated,
unknown
tags
string[]

Comma-separated list of tags to filter by (e.g. tags=professional,studio). Matches avatars with ANY of the given tags. Tags are generated alongside description/displayTags and are lowercase.

onlyOneShot
boolean
default:false

Only return one-shot avatars

Response

Successfully retrieved avatars

data
object[]
meta
object

Pagination metadata returned alongside the data array of every list endpoint.

Last modified on July 10, 2026