---
title: "Get an Avatar by id"
method: GET
path: "/avatars/{id}"
---

# Get an Avatar by id

`GET /avatars/{id}`

Returns a single Avatar identified by its id

## Path parameters

- `id` string, required — The id of the Avatar to retrieve

## Response `200`

Detailed information about the Avatar

- Avatar
  - `id` string, uuid
  - `name` string
  - `actorName` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `gestures` object[] — A list of labelized gestures available for your avatar.
    - `label` string — A label for user readability. Can be setup from the app's UI.
    - `slug` string — Allows identifying the gesture when using it for a specific moment.
    - `startFrame` number — The startFrame of the source Avatar video to be used as start for the video template.
  - `status` 'NOT_TRAINED' | 'TRAINING' | 'TRAINING_FAILED' | 'IDLE' | 'REFUSED' — * NOT_TRAINED - Initial state after VIDEO mode avatar creation (before training starts) * TRAINING - Avatar is currently training. For IMAGE mode avatars, this is the initial status after creation. * TRAINING_FAILED - Training process failed * IDLE - Avatar is ready to use * REFUSED - Avatar was refused by moderation
  - `width` integer
  - `height` integer
  - `thumbnailUrl` string — The url of the thumbnail of the avatar (low resolution).
  - `coverImageUrl` string — The url of the cover image of the avatar (high resolution).
  - `extras` object — A dictionary of custom key-value pairs to extend the Avatar metadata. Maximum of 5 key-value pairs of 256 characters allowed.
  - `orientation` 'ASPECT_RATIO_16_9' | 'ASPECT_RATIO_9_16'
  - `model` 'ARGIL_V1' | 'ARGIL_ATOM'

## Other responses

- `404` — Avatar not found

## Changes

- **2025-12-03** `8deefa349e1d` — 1 warning, 1 info
  - removed the optional property `createAt` from the response with the `200` status
  - added the optional property `createdAt` to the response with the `200` status
- **2025-10-24** `9346a335d8ce` — 3 info
  - added the optional property `actorName` to the response with the `200` status
  - added the optional property `model` to the response with the `200` status
  - added the optional property `orientation` to the response with the `200` status
- **2025-04-10** `0f305512c004` — 1 info
  - added the optional property `coverImageUrl` to the response with the `200` status

[Change history](https://skmtc.dev/argildotai/apis/argil-api/changes/avatars/:id/get.md)

---

[API](https://skmtc.dev/argildotai/apis/argil-api.md) · [All operations](https://skmtc.dev/argildotai/apis/argil-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/argildotai/argil-api/revisions/f3d0315da0f0/schema)