# The avatar's monetization eligibility and earnings

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

`GET /v1/avatars/{avatarId}/monetization`

What Creator Studio's monetization panel shows: whether the avatar is
monetized, its last 30 days against the eligibility requirements, the
account's cap on monetizing avatars, and what it has earned. The 30-day
numbers leave out the account's own conversations. Earnings are in
microcredits (100 = 1 credit); the current cycle is the account's
billing cycle. Requires `avatars:read`; an avatar-scoped key reads only
its own avatar.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `avatarId` | path | yes |  |

## Responses

| Status | Description | Schema |
| --- | --- | --- |
| `200` | The avatar's monetization eligibility and earnings. | `AvatarMonetization` |
| `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 \| avatar_not_allowed \| account_not_allowed | none |
| `404` | avatar_not_found | none |
| `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 |
| --- | --- | --- | --- |
| `monetized` | boolean | yes | Whether monetization is on for the avatar. |
| `eligible` | boolean | yes | Whether the last 30 days meet every requirement. |
| `last30Days` | object | yes | Completed conversations of the last 30 days, the account's own left out. |
| `requirements` | object | yes | The 30-day thresholds of eligibility, and which the avatar meets. |
| `accountCap` | object | yes | The account's limit on monetizing avatars. |
| `earnings` | object | yes | What the avatar has earned, in microcredits (100 = 1 credit); the current cycle is the account's billing cycle. |