Skip to main content
GET
/
v3
/
avatars
/
{group_id}
Get avatar group details
curl --request GET \
  --url https://api.heygen.com/v3/avatars/{group_id} \
  --header 'x-api-key: <api-key>'
{}

Authorizations

​
x-api-key
string
header
required

HeyGen API key. Obtain from your HeyGen dashboard.

Path Parameters

​
group_id
string
required

Unique avatar group identifier

Response

Successful response

​
data
AvatarGroupItem · object

A single avatar group in the list response.

Groups are containers for looks (outfits/styles). To determine avatar type and engine compatibility, fetch the looks via GET /v3/avatars/looks.