GET
/api/check-usageReturns this month's evaluation usage for the account that owns the API key. Also accepts POST.
Scope: usage
Example Request
curl https://app.adalign.io/api/check-usage \ -H "Authorization: Bearer adal_your_key_here"
Response
{
"used": 212,
"limit": 1500,
"remaining": 1288,
"canEvaluate": true,
"nextReset": "2026-11-01T00:00:00.000Z",
"tier": "studio",
"userEmail": "you@example.com"
}Without an API key the endpoint reports the caller's anonymous allowance instead: limit 1 per IP per month, an ipAddress field (partly masked) and no tier.
Response Fields
| Field | Type | Description |
|---|---|---|
| used | integer | Evaluations used this month |
| limit | integer | Monthly evaluation limit for your tier |
| remaining | integer | Evaluations remaining this month |
| canEvaluate | boolean | Whether you can run more evaluations |
| nextReset | string | ISO date when the counter resets |
| tier | string | Internal plan id: studio (Scale) or enterprise (Portfolio, Enterprise) for API accounts; free, growth or agency otherwise |
| userEmail | string | Email of the account the key belongs to |
Errors
401 Invalid, expired or revoked API key
403 Key lacks the usage scope
404 The account behind the key no longer exists