# Sponsor pool balance and settings

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

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

Callable by an API key (`avatars:read`) or a signed-in user acting for
the account. Sponsoring otherwise takes an API key with
`billing:write` or a signed-in user, who sponsors the account's
avatars as in Studio without holding that scope.

## Parameters

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

## Responses

| Status | Description | Schema |
| --- | --- | --- |
| `200` | Balance and settings. | `AvatarSponsor` |
| `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 | none |
| `404` | avatar_not_found | none |

## `200` response fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `balance` | object | yes |  |
| `settings` | object | yes |  |
