---
title: "Get avatar"
method: GET
path: "/avatar-profiles/{id}"
tags: ["Avatar Profiles"]
---

# Get avatar

`GET /avatar-profiles/{id}`

## Request

- Base URL: `https://api.mosaic.so`
- URL: `https://api.mosaic.so/avatar-profiles/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Return one AI Avatar, including processing status and reference URLs when available.

## Path parameters

- `id` string, required

## Response `200`

Avatar profile

- object
  - `id` string, uuid, required: Avatar profile ID. Pass this as avatar_profile_id in an AI Avatar tile.
  - `video_preview_url` string, uri, nullable, required: Signed video preview URL. Null until a preview/reference video is available.
  - `name` string, required: Avatar display name.
  - `status` 'pending' | 'processing' | 'ready' | 'failed', required: Avatar processing state. Ready means fully prepared; pending/processing can be used while the run waits; failed cannot be used.
  - `status_message` string, nullable, required: Error message when status is failed; otherwise null.

## Other responses

- `401`: Authentication failed
- `403`: Access denied
- `404`: Resource not found

---

[API](https://skmtc.dev/mosaic/apis/mosaic-ai-api.md) - [All operations](https://skmtc.dev/mosaic/apis/mosaic-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mosaic/apis/mosaic-ai-api/revisions/c20e9fc606a4?raw)