free_tier_exhausted

Why it happens

Search, coverage, usage and health are free. Company profile, officers, shareholders, ownership, links, documents, financials, verify, batch verify and valid VAT lookups are paid calls at $0.05 each after the first 100 free paid calls.

How to fix it

Add credit from the dashboard or use a ck_test_ key for fixtures. GET /v1/usage shows the free calls used and the current charge for the period.

Example response

{
  "type": "https://corpoapi.com/errors/free_tier_exhausted",
  "title": "Free tier exhausted",
  "status": 402,
  "code": "free_tier_exhausted",
  "detail": "The free starter allowance is used up. Add credit to continue.",
  "request_id": "8f3c2a1e-5b7d-4c9a-9e2f-1a2b3c4d5e6f"
}