# GET - Metadata

Get a 2D render of an avatar for stickers or profile pictures.

## Get avatar 2D render by id.

<mark style="color:blue;">`GET`</mark> `https://models.enochavatar.me`

Get an avatar 2D image with desired settings.&#x20;

#### Path Parameters

| Name                                           | Type   | Description      |
| ---------------------------------------------- | ------ | ---------------- |
| avatarId.png<mark style="color:red;">\*</mark> | String | ID of an avatar. |

#### Query Parameters

| Name        | Type   | Description                             |
| ----------- | ------ | --------------------------------------- |
| scene       | String | Name of portrait type to render.        |
| blendShapes | String | Map of 3D meshes to their blend shapes. |

{% tabs %}
{% tab title="200: OK 2D Render of the avatar." %}

{% endtab %}

{% tab title="404: Not Found The requested avatar is not available." %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

### Parameters, expected values, and examples

{% tabs %}
{% tab title="/avatarId.png" %}
ID of an avatar with .png file extension.

**Expected values (String)**

* `6185a4acfb622cf1cdc49348.png`

{% hint style="info" %}
It may take some time to render the image in the backend for the initial request. For subsequent requests, the images will be fetched from cache and delivered much faster.
{% endhint %}
{% endtab %}

{% tab title="Example" %}
**Request avatar render by ID.**

```
https://models.enochavatar.me/6185a4acfb622cf1cdc49348.png
```

**Returned value**

You will receive a .png image[.](https://docs.fileformat.com/3d/glb/)&#x20;

![](broken-reference)
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="?scene" %}
Name of the portrait type to render.

**Expected values (String)**

* `fullbody-portrait-v1` - Creates a portrait from a full-body avatar...
* `fullbody-portrait-v1-transparent`  - ... with transparent background (default).
* `halfbody-portrait-v1` - Creates a portrait from a half-body avatar...
* `halfbody-portrait-v1-transparent`  - ... with transparent background (default).
* `fullbody-posture-v1-transparent`  - Creates a portrait with a pose from a full-body avatar.
  {% endtab %}

{% tab title="Example" %}
**Request avatar render with transparent fullbody posture**

```
https://models.enochavatar.me/6185a4acfb622cf1cdc49348.png?scene=fullbody-posture-v1-transparent
```

![](broken-reference)

**Request avatar render for full body portrait on dark background**

```
https://models.enochavatar.me/6185a4acfb622cf1cdc49348.png?scene=fullbody-portrait-v1
```

![](broken-reference)
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="?blendShapes" %}
Map of 3D meshes to their blend shapes.

**Expected values (String)**\
`blendShapes[Wolf3D_Head][mouthSmile]=0.2 }`&#x20;

* &#x20;`Wolf3D_Head` is the affected node in the avatar.&#x20;
* `mouthSmile` is an example of a blend shape included in the avatar.

You can find all available blend shapes in Full-body Avatars.

{% hint style="info" %}
You can combine multiple blend shapes by concatenating them with '&' as shown in the following example:

`?blendShapes[Wolf3D_Head][mouthSmile]=0.2`**`&`**`blendShapes[Wolf3D_Head][browInnerUp]=0.2`
{% endhint %}
{% endtab %}
{% endtabs %}