> ## 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 this month's answers against your allowance

> How many answers your organisation has had this calendar month against its allowance, by day, surface and assistant. Counts only.

Returns your organisation's answers for the current calendar month (UTC) against its monthly allowance. There are no parameters: the organisation is the one your credential belongs to, and the period is always the current month. See [Usage and limits](https://docs.mithunai.com/analyze/usage-and-limits.md) for what counts as an answer.

When `answers.state` is `at_limit`, a new question on any surface is refused with `429` and the code `quota_exceeded`. See [Errors](https://docs.mithunai.com/api-reference/errors.md#the-monthly-answer-limit).

The response carries counts, dates and identifiers only. It never contains question or answer text, and it contains no cost.

Requires the owner, admin or editor role. Members and dataset operators receive `403`.

## Response

**period** `object` *required*

The calendar month the counts cover.

**properties**

**start** `string` *required*

Inclusive start, ISO 8601 in UTC.

**end** `string` *required*

Exclusive end, ISO 8601 in UTC. This is when the count starts again.

**answers** `object` *required*

This month's use against the allowance.

**properties**

**used** `integer` *required*

Answers counted so far, on every surface together. Includes an answer still being written.

**allowance** `integer | null` *required*

The monthly allowance. `null` means your organisation has no limit.

**remaining** `integer | null` *required*

`allowance` minus `used`, never below `0`. `null` when there is no limit.

**state** `string` *required*

`ok`, `approaching` (80% of the allowance or more is used), `at_limit` (the next question will
be refused) or `unlimited`.

**daily** `object[]` *required*

One entry for every day of the month up to today, oldest first. A day with no answers is `0`.

**properties**

**date** `string` *required*

The UTC calendar day, `YYYY-MM-DD`.

**answers** `integer` *required*

Answers given that day.

**surfaces** `object[]` *required*

Answers by where the question was asked.

**properties**

**surface** `string` *required*

`console`, `api`, `widget` or `mcp`.

**answers** `integer` *required*

Answers given on that surface.

**assistants** `object[]` *required*

Answers by assistant.

**properties**

**assistant\_id** `string` *required*

The assistant (UUID).

**answers** `integer` *required*

Answers that assistant gave.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl https://YOUR_DEPLOYMENT/mithunai/api/v1/usage \
  -H "Authorization: Bearer $MITHUNAI_API_KEY"
```

```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "period": { "start": "2026-10-01T00:00:00+00:00", "end": "2026-11-01T00:00:00+00:00" },
  "answers": { "used": 850, "allowance": 1000, "remaining": 150, "state": "approaching" },
  "daily": [
    { "date": "2026-10-01", "answers": 61 },
    { "date": "2026-10-02", "answers": 74 }
  ],
  "surfaces": [
    { "surface": "console", "answers": 40 },
    { "surface": "widget", "answers": 810 }
  ],
  "assistants": [{ "assistant_id": "aaaaaaaa-1111-4111-8111-aaaaaaaaaaaa", "answers": 850 }]
}
```


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