# The account's creator wallet and earnings

URL: https://www.atmee.ai/docs/v2/api/reference/account/getAccountEarnings

`GET /v1/account/earnings`

What the account's monetized avatars earned, what was paid out, and
the wallet balance between the two, in microcredits (100 microcredits
= 1 credit), as Studio's billing page shows them. This is not the
credit balance sessions spend (`GET /v1/account/balance`). One
avatar's earnings are in `GET /v1/avatars/{avatarId}/monetization`.

Any account-wide key with `avatars:read` may read it, and so may a
signed-in user acting for the account; an avatar-scoped key is
answered `403 avatar_not_allowed`.

## Responses

| Status | Description | Schema |
| --- | --- | --- |
| `200` | The wallet. | `AccountEarnings` |
| `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 | `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 |
| --- | --- | --- | --- |
| `walletBalanceMicrocredits` | integer | yes | Earned and not yet paid out. |
| `totalEarningsMicrocredits` | integer | yes |  |
| `totalPayoutsMicrocredits` | integer | yes |  |