Limits and errors

Where to find your limits

Live free-tier allowances, paid-plan ceilings, and current usage are in app.norcube.com → DomainRadar → Limits, and on the pricing page.

DomainRadar tracks quotas across several dimensions:

Per check method – Bloom, DNS-verified, RDAP info, full WHOIS each have their own monthly free-tier allowance. Usage beyond free-tier bills at the per-method rate.
Concurrent checks – maximum simultaneous lookups in flight.
Bulk job size – maximum domains per bulk job.
Bulk jobs per hour – rate limit on creating new bulk jobs.
Name-generator jobs per hour – rate limit on generation requests.
Active watchers – Brand Monitor is metered per watcher-hour.

The exact numbers depend on your plan; see the live page above for authoritative values.

Billing gate

If your organization has unpaid invoices past the grace period, write endpoints return 402 PAYMENT_REQUIRED. Reads continue working. See Platform → Billing → Dunning.

Error codes

HTTP	Code	Meaning
400	`INVALID_INPUT`	Validation failed.
401	`INVALID_TOKEN`	Token missing/expired.
402	`PAYMENT_REQUIRED`	Past dunning grace.
403	`FORBIDDEN`	Not allowed for this org.
404	`NOT_FOUND`	Job, watcher, or hit doesn't exist.
422	`INVALID_STATE`	E.g., cancelling a finished job.
429	`RATE_LIMITED`	Exceeded a rate limit.
500	`INTERNAL_ERROR`	Unexpected server error.
503	`SERVICE_UNAVAILABLE`	Transient. Retry with backoff.

Per-check errors

A single domain in a check (single or bulk) can fail without failing the overall request. Per-domain errors:

Code	Meaning
`domain_invalid`	Not a parseable FQDN.
`tld_unsupported`	The TLD isn't covered by DomainRadar.
`whois_unavailable`	The registry's WHOIS server didn't respond.
`rdap_unavailable`	The registry's RDAP server didn't respond.

Errored domains in a bulk job don't count against billing.

Status

Live status at status.norcube.com.