Usage
Returns usage for the current period: AI and re-sync credits (at the organization level) and AI credits broken down by agent, plus agents and knowledge base capacity.GET https://app.chatnorris.ai/api/v2/usage
Authorization: Bearer <your_api_key>
Response
{
"status": "success",
"data": {
"messages": {
"used": 3420,
"limit": 5000
},
"chatbots": {
"used": 3,
"limit": 5
},
"knowledge_base_chars": {
"used": 820000,
"limit": 5000000
},
"credits": {
"ai": {
"used": 1200,
"limit": 3000,
"remaining": 1800
},
"resync": {
"used": 500,
"limit": 15000,
"remaining": 14500
}
},
"chatbot_credits": [
{
"id": "bot_xyz789",
"name": "Support agent",
"credits": {
"ai": {
"used": 300,
"limit": 500,
"remaining": 200
}
}
}
],
"period": {
"start": "2026-06-01T00:00:00.000Z",
"end": "2026-07-01T00:00:00.000Z"
}
}
}
Response fields
| Field | Type | Description |
|---|---|---|
messages.used | number | Legacy alias: reflects the same usage as credits.ai.used, kept for compatibility. Prefer credits.ai for new integrations. |
messages.limit | number | null | Legacy alias for the ai bucket limit (null = unlimited) |
chatbots.used | integer | Active agents in the organization |
chatbots.limit | integer | null | Agent limit stored on the account. It’s a legacy field and may not reflect purchased additional agents; the current limit is shown in Billing & usage → Usage |
knowledge_base_chars.used | integer | Characters indexed in the KB |
knowledge_base_chars.limit | integer | null | The plan’s character limit (null = unlimited) |
credits.ai | object | Usage of the organization’s AI credit bucket in the current period |
credits.resync | object | Usage of the organization’s re-sync credit bucket in the current period |
credits.<bucket>.used | number | Credits consumed from that bucket in the current period |
credits.<bucket>.limit | number | null | Limit of that bucket (null = unlimited) |
credits.<bucket>.remaining | number | null | Remaining credits in that bucket (null if the limit is unlimited) |
chatbot_credits | array | Credit usage broken down by agent |
chatbot_credits[].id | string | Agent ID |
chatbot_credits[].name | string | Agent name |
chatbot_credits[].credits.ai.limit / .remaining | number | null | Only have a value if that agent has its own credit cap turned on (agent Settings → Limits); otherwise they’re null |
period.start | string | Start of the billing period (ISO 8601) |
period.end | string | End of the billing period / counter reset date (ISO 8601) |
A
null limit means that resource is unlimited on your current plan. The response doesn’t include the email credit bucket.