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.
GET
/
usage
curl https://YOUR_DEPLOYMENT/mithunai/api/v1/usage \
-H "Authorization: Bearer $MITHUNAI_API_KEY"
{
"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 }]
}
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 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.
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
object
required
object
required
This month’s use against the allowance.
Show properties
Show properties
integer
required
Answers counted so far, on every surface together. Includes an answer still being written.
integer | null
required
The monthly allowance.
null means your organisation has no limit.integer | null
required
allowance minus used, never below 0. null when there is no limit.string
required
ok, approaching (80% of the allowance or more is used), at_limit (the next question will
be refused) or unlimited.object[]
required
object[]
required
object[]
required
curl https://YOUR_DEPLOYMENT/mithunai/api/v1/usage \
-H "Authorization: Bearer $MITHUNAI_API_KEY"
{
"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 }]
}
Last modified on November 7, 2026
curl https://YOUR_DEPLOYMENT/mithunai/api/v1/usage \
-H "Authorization: Bearer $MITHUNAI_API_KEY"
{
"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 }]
}