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

# Check Usage

> Returns your current usage count, plan limit, and remaining verifications

## Overview

Returns real-time usage stats for your API key — how many intent verifications you've consumed this month, your plan limit, and how many remain.

No request body needed — authentication is via your `X-Citadel-Key`.

***

## Request

<ParamField header="X-Citadel-Key" type="string" required>
  Your Aether Citadel API key (`ack_live_...`)
</ParamField>

***

## Response

<ResponseField name="email" type="string">
  The email address associated with your account.
</ResponseField>

<ResponseField name="plan" type="string">
  Your current plan name (e.g. `Citadel Starter`, `Citadel Pro`).
</ResponseField>

<ResponseField name="usage_count" type="integer">
  Total intent verifications consumed this billing period.
</ResponseField>

<ResponseField name="rate_limit" type="integer">
  Maximum verifications allowed per billing period.
</ResponseField>

<ResponseField name="remaining" type="integer">
  `rate_limit - usage_count`. How many verifications you have left.
</ResponseField>

***

## Example

```bash theme={null}
curl https://api.aethercitadel.cloud/v1/tenant/usage \
  -H "X-Citadel-Key: ack_live_YOUR_KEY"
```

```json theme={null}
{
  "email": "you@company.com",
  "plan": "Citadel Starter",
  "usage_count": 12456,
  "rate_limit": 50000,
  "remaining": 37544
}
```

***

## Error Responses

| Status | Error                          | Meaning                              |
| ------ | ------------------------------ | ------------------------------------ |
| `401`  | `Missing X-Citadel-Key header` | No key provided                      |
| `401`  | `Invalid or inactive API key`  | Key doesn't exist or was deactivated |
| `503`  | `Multi-tenancy not configured` | Contact support                      |