Usage & Billing
IdenticAPI bills by usage units — a simple counter for how much of the platform you consume each month. Every successful security check consumes units from your plan quota.
What is a usage unit?
One usage unit equals one security check on a single API endpoint. The usage_units field in every response tells you exactly how many units that request consumed.
Unit consumption by endpoint
| Endpoint | Units per request |
|---|---|
POST /api/v1/security/prompt-injection | 1 |
POST /api/v1/security/pii-secrets | 1 |
POST /api/v1/security/output-safety | 1 |
POST /api/v1/security/agent-action | 1 |
POST /api/v1/guard (Unified Guard) | 1 per check (max 4) |
Example: a Unified Guard request with checks: ["prompt_injection", "pii_secrets"]consumes 2 usage units.
Monthly quotas by plan
| Plan | Monthly usage units | Price |
|---|---|---|
| Free | 500 | Free |
| Developer | 10,000 | €29/month |
| Growth | 100,000 | €99/month |
Billing period
Usage resets on the first day of each calendar month. Your current consumption is tracked in the usage dashboard and reflected in the usage_unitsfield of each API response.
Quota exceeded
When your monthly quota is exhausted, new requests return HTTP 429 with error codequota_exceeded. Upgrade your plan on the pricing page to increase capacity immediately.
What counts toward usage?
- Units are reserved at the start of each authenticated request, before the detector runs.
- Validation errors (
invalid_request) still consume units once authentication succeeds. - Authentication failures and rate-limit errors occur before usage reservation.
Monitoring usage
- View current-period totals and daily breakdowns in your dashboard.
- Each API response includes
usage_unitsfor that specific request. - Growth plan subscribers receive usage alerts when approaching quota limits.