Start
Limits and usage
The daily allowance for each API, what counts as a run, and how to see what is left.
The daily allowance
| Agent Lens | Agent Lens playground API | Integrity Lens | |
|---|---|---|---|
| Endpoints | /v1/score and the integrations (/v1/pre-action, /v1/traces, /aegis/*) | /v1/agent/* | /v1/integrity/* and the web app |
| Runs per day | 1,000 | 10 | 10 |
| What is one run | One scored answer or agent step (POST /v1/score, POST /v1/pre-action, POST /aegis/post-action), or one POST /v1/traces batch | One POST /v1/agent/score | One scan: POST /v1/integrity/scans, a scan started in the web app, or a new POST /v1/integrity/scan |
| Requests per minute | 300 | 10 | 10 |
| Resets | 00:00 UTC | 00:00 UTC | 00:00 UTC |
The allowance belongs to your account, not to a key: all your keys share it, and creating a new key does not reset it.
What does not count
- Anything that fails: an error, a timeout, "busy", the service being offline.
- With the one-call
POST /v1/integrity/scan: results that were already stored (the same model revision, scanned before by anyone, comes back at once with"cached": true), and models outside the supported families (they come backUnknownwithout a scan). - Read-only calls:
/v1/me,/v1/health,/v1/probes,/v1/decisions/{id},/v1/requests,/v1/runs, and every Integrity LensGET(scans, models, reports, sources, families). - Labels (
POST /v1/labels) and the console's Why was this flagged? re-reads.
Seeing what is left
- Every run answers with two headers:
X-Quota-LimitandX-Quota-Remaining. GET /v1/mereturns today's usage for each product (agent-lens-appis the Agent Lens API above) (see Account).- Profile → API keys on neuronlens.com shows the same.
When the allowance is used up
The API answers 429 with "error": "daily_limit", the time it resets, and where to ask for more:
{
"error": "daily_limit",
"detail": "You have used today's 1000 Agent Lens runs. They reset at 00:00 UTC.",
"limit": 1000,
"resets_at": "2026-10-13T00:00:00Z",
"upgrade_url": "https://neuronlens.com/about",
"request_id": "req_9bc51e9e6bd6"
}
Need more for an evaluation or a pilot? Contact us.
Other limits
| Limit | Value |
|---|---|
| Requests per minute, per account | 300 for Agent Lens, 10 for the others (429 rate_limited with Retry-After) |
| Request body | 2 MB for /v1/score, /v1/pre-action, /v1/post-action, /v1/traces and /aegis/*; 64 KB for the rest |
| Agent Lens time per call | about 0.5–2 s |
| Integrity Lens time per scan | about 30–60 s for a new model; instant when stored |