> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mithunai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get your plan, its limits and what is in use

> Your organisation's plan, whose AI keys answer, each limit and how much of it is used, the trial end and this month's answers. No prices.

Returns your organisation's plan: its name, whether answers use MITHUNAI's AI or your own provider keys, each limit and how much of it is in use now, your trial end, and this month's answers. There are no parameters: the organisation is the one your credential belongs to. See [Plan and usage](https://docs.mithunai.com/administration/plan-and-usage.md).

The plan is read-only here. MITHUNAI staff set it, and you are invoiced by hand, so the response carries no price and nothing here changes the plan. Requires `usage.read` (owner, admin or editor). An organisation not on a plan gets `plan: null` and no limits, which means the deployment's defaults apply.

## Response

**plan** `string | null` *required*

`trial`, `starter`, `growth`, `business`, `enterprise` or `sovereign`. `null` when no plan is set.

**plan\_name** `string | null`

The plan's name as shown on screen.

**track** `string` *required*

`managed` when answers use MITHUNAI's AI keys; `byok` when they use your own. See
[Your own AI provider keys](https://docs.mithunai.com/administration/model-keys.md).

**period** `string | null`

`monthly` or `yearly`: how you are invoiced.

**overage\_opt\_in** `boolean` *required*

Whether answers continue past the allowance, up to twice it. Set by MITHUNAI staff on request.

**limits** `object | null`

`monthly_answers`, `assistants`, `documents`, `widgets`, `seats` and `geo_prompts`. A `null` limit
is no plan limit.

**in\_use** `array` *required*

One entry per limit: `limit`, `used` now and `maximum` (`null` for no plan limit). Seats count
members and pending invitations.

**trial\_ends\_at** `string | null`

When your trial ends, ISO 8601 in UTC.

**usage** `object`

This month's answers, as [Get answer allowance](https://docs.mithunai.com/api-reference/analytics/get-answer-allowance.md)
reports them, with `overage` and `overage_ceiling`.

When a create would pass a limit, the create answers `403` with the code `plan_limit` and a message
naming the limit. Nothing already created is removed. See [Errors](https://docs.mithunai.com/api-reference/errors.md).

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "$MITHUNAI_URL/mithunai/api/v1/plan" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.