Rate limits

nCodeCloud throttles requests at two layers: per-key (production) and per-IP (public demo).

Per-key limits (production)#

Every license key has a credit balance from the pricing pack it belongs to. Credits are consumed FIFO across active packs.

• Lite Pack — 1,000 lookups, 12-month validity.
• Pro Pack — 10,000 lookups, 12-month validity.
• Enterprise / Custom — negotiated.

When a pack is exhausted, calls continue at +20% overage pricing for 60 days. After 60 days, the service is paused until a new pack is purchased.

Per-IP limits (demo)#

The public Live demo and any traffic against /api/demo/* are limited to 30 requests per 5 minutes per IP. Bursts beyond that return HTTP 429. The window resets sliding, so steady low traffic continues to work after a short pause.

The demo limits exist to protect the shared demo license key from abuse. Production keys are not subject to per-IP limits.

Handling 429 responses#

When you hit a per-IP limit you receive:

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{ "error": "Rate limit exceeded" }

Back off and retry after 5 minutes, or sign up for a Trial pack and switch to your own license key to remove the per-IP cap entirely.

Headers#

We do not currently emit X-RateLimit-* headers. Production-scale rate-limit observability is on the roadmap.