# The account's plan, limits, prices and capture quota

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

`GET /v1/account`

The plan the account is on (and the one it changes to at the end of
the cycle, if any), the limits that apply to its API usage, what a
session minute, a preview clip and (where generation is offered,
`pricing.generation`) one generation call cost, and how many v2 captures are
queued or running against the pending cap. Prices are in
microcredits (100 microcredits = 1 credit). A conversation
(`POST /v1/sessions`) is charged `sessionPerMinuteMicrocredits` with a
v1 avatar and `sessionV2PerMinuteMicrocredits` with a v2 one; an
avatar session (render only) the avatar engine's render rate
(`renderV1PerMinuteMicrocredits` or `renderV2PerMinuteMicrocredits`). A limit, or a plan
field, that is absent is not set (a limit absent is not capped by the
plan). `payouts` says whether the account can be paid out, which
monetizing an avatar needs.

Readable by the same callers as `GET /v1/account/balance`.

## Responses

| Status | Description | Schema |
| --- | --- | --- |
| `200` | The account. | `Account` |
| `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 (a key with neither sessions nor avatars:read) \| account_not_allowed (a user token whose X-Account-Id names an account the user may not act for) | `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 |
| --- | --- | --- | --- |
| `accountId` | string | yes |  |
| `plan` | `AccountPlan` | yes |  |
| `limits` | `AccountLimits` | yes |  |
| `pricing` | `AccountPricing` | yes |  |
| `captureQuota` | `CaptureQuota` | yes | v2 captures queued or running, against the pending cap (as X-RateLimit-* on a v2 create). |
| `payouts` | `AccountPayouts` | no | Whether the account can be paid out (its Stripe Connect payout account), as last synced from Stripe. Monetizing an avatar needs `verified`; payouts are set up in Creator Studio. Absent when the database does not report it. |
| `links` | `AccountLinks` | no | The account's pages on the Atmee website, ready to hand to a person. Absent when this deployment does not know the website's address. |
| `v2Access` | string (`granted`, `invite_required`, `unavailable`) | no | Whether this account may build v2 avatars (`engine: v2`). `granted`: it may. `invite_required`: v2 is invite-only for now and this account has not been let in; v2 creates, candidates, versions, the conductor and v2 rebuilds answer 403 `v2_access_required` until it redeems an invite code in Creator Studio (`links.billing`). Use `engine: v1` meanwhile. `unavailable`: v2 is not offered on this server. Absent when it could not be determined. |