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

# Uso

> Consultar el consumo actual del plan de tu organización.

# Uso

Devuelve el consumo actual del período de facturación en curso: mensajes, agentes y capacidad de base de conocimiento.

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

**Scope requerido:** ninguno (solo autenticación válida)

***

## Respuesta

```json theme={null}
{
  "status": "success",
  "data": {
    "messages": {
      "used": 3420,
      "limit": 5000
    },
    "chatbots": {
      "used": 3,
      "limit": 5
    },
    "knowledge_base_chars": {
      "used": 820000,
      "limit": 5000000
    },
    "period": {
      "start": "2026-06-01T00:00:00.000Z",
      "end": "2026-07-01T00:00:00.000Z"
    }
  }
}
```

### Campos de respuesta

| Campo                        | Tipo    | Descripción                                                              |
| ---------------------------- | ------- | ------------------------------------------------------------------------ |
| `messages.used`              | integer | Mensajes enviados en el período actual                                   |
| `messages.limit`             | integer | Límite de mensajes del plan (`-1` = ilimitado)                           |
| `chatbots.used`              | integer | Agentes creados actualmente                                              |
| `chatbots.limit`             | integer | Límite de agentes del plan (`-1` = ilimitado)                            |
| `knowledge_base_chars.used`  | integer | Caracteres indexados en la KB                                            |
| `knowledge_base_chars.limit` | integer | Límite de caracteres del plan (`-1` = ilimitado)                         |
| `period.start`               | string  | Inicio del período de facturación (ISO 8601)                             |
| `period.end`                 | string  | Fin del período de facturación / fecha de reset de contadores (ISO 8601) |

<Note>
  Un límite de `-1` indica que ese recurso es ilimitado en tu plan actual.
</Note>