---
description: Resolves a list of current user's avatar ids.‌
---

# List

### GET /avatars

#### Request

{% tabs %}
{% tab title="cURL" %}
```bash
curl -X GET "https://api.loomai.com/v0.5/avatars?page={page}&pagesize={pagesize}&fields={fields}"
```
{% endtab %}

{% tab title="Example" %}
```
curl -X GET "https://api.loomai.com/v0.5/avatars?fields=image,labels"
```
{% endtab %}
{% endtabs %}

| Parameter  | Transport | Type      | Description                                                                                 |
| ---------- | --------- | --------- | ------------------------------------------------------------------------------------------- |
| `page`     | `query`   | `integer` | Pagination / Page (optional, default 0).                                                    |
| `pagesize` | `query`   | `integer` | Pagination / Page Size (optional, default 100, max 100).                                    |
| `fields`   | `query`   | `string`  | Comma-separated list of fields to include (optional, values `image`, `labels`, `features`). |

####

#### Response

On success the endpoint returns HTTP 200 OK as well as a JSON body containing the ids, dates of last modification as well as optionally selected `fields` of the user's previously stored avatars.

{% tabs %}
{% tab title="Schema" %}
```javascript
{
  "entries": [
    {
      "id": int64,
      "updated_at": "string", // ISO-8601 DATETIME
      "image": {
        "id": int64,
        "width": int32,
        "height": int32,
        "channels": int32
      },
      "labels": {
        "entries": [
          {
            "name": "string",
            "value": "string"
          },
          ...
        ]
      }
    }
  ]
}
```
{% endtab %}

{% tab title="Example" %}
```javascript
{
  "entries": [
    {
      "id": 5723980430835712,
      "updated_at": "2019-10-28T01:36:45Z",
      "image": {
        "id": 5643411273547776,
        "width": 3024,
        "height": 4032,
        "channels": 3
      },
      "labels": {
        "entries": [
          {
            "name": "app",
            "value": "example"
          }
        ]
      }
    }
  ]
}
```
{% endtab %}
{% endtabs %}

###
