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

# Usage

> Check your organization's current plan usage.

# 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.

```http theme={null}
GET https://app.chatnorris.ai/api/v2/usage
Authorization: Bearer <your_api_key>
```

**Required scope:** none (valid authentication only)

***

## Response

```json theme={null}
{
  "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) |

> [!NOTE]
>
> A `null` limit means that resource is unlimited on your current plan. The response doesn't include the email credit bucket.


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