# List the account's avatars

URL: https://www.atmee.ai/docs/v2/api/reference/avatars/listAvatars

`GET /v1/avatars`

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `limit` | query | no |  |
| `before` | query | no | Cursor -- return avatars created before this timestamp. |

## Responses

| Status | Description | Schema |
| --- | --- | --- |
| `200` | Avatars, newest first. | `AvatarListResponse` |
| `401` | Missing or invalid API key -- or a user token that is invalid, anonymous, or of a user who may act for no account (invalid_login) | none |
| `403` | insufficient_scope \| account_not_allowed (a user token whose X-Account-Id names an account the user may not act for) | `ApiErrorResponse` |
| `409` | account_ambiguous -- a user token of a user who may act for several accounts, without an `X-Account-Id` header naming one. | `ApiErrorResponse` |

## `200` response fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `items` | array of `AvatarSummary` | yes |  |
| `nextBefore` | string | no | Pass as `before` to fetch the next page; null when exhausted. |