Check Usage
Tenant API
Check Usage
Returns your current usage count, plan limit, and remaining verifications
GET
Check Usage
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 yourX-Citadel-Key.
Request
Your Aether Citadel API key (
ack_live_...)Response
The email address associated with your account.
Your current plan name (e.g.
Citadel Starter, Citadel Pro).Total intent verifications consumed this billing period.
Maximum verifications allowed per billing period.
rate_limit - usage_count. How many verifications you have left.Example
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 |