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.
GET
/
plan
curl "$MITHUNAI_URL/mithunai/api/v1/plan" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
{
"plan": {},
"plan_name": {},
"track": "<string>",
"period": {},
"overage_opt_in": true,
"limits": {},
"in_use": [
{}
],
"trial_ends_at": {},
"usage": {}
}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.
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
When a create would pass a limit, the create answers
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
string | null
required
trial, starter, growth, business, enterprise or sovereign. null when no plan is set.string | null
The plan’s name as shown on screen.
string
required
managed when answers use MITHUNAI’s AI keys; byok when they use your own. See
Your own AI provider keys.string | null
monthly or yearly: how you are invoiced.boolean
required
Whether answers continue past the allowance, up to twice it. Set by MITHUNAI staff on request.
object | null
monthly_answers, assistants, documents, widgets, seats and geo_prompts. A null limit
is no plan limit.array
required
One entry per limit:
limit, used now and maximum (null for no plan limit). Seats count
members and pending invitations.string | null
When your trial ends, ISO 8601 in UTC.
object
This month’s answers, as Get answer allowance
reports them, with
overage and overage_ceiling.403 with the code plan_limit and a message
naming the limit. Nothing already created is removed. See Errors.
curl "$MITHUNAI_URL/mithunai/api/v1/plan" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
Last modified on November 12, 2026
curl "$MITHUNAI_URL/mithunai/api/v1/plan" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
{
"plan": {},
"plan_name": {},
"track": "<string>",
"period": {},
"overage_opt_in": true,
"limits": {},
"in_use": [
{}
],
"trial_ends_at": {},
"usage": {}
}