Skip to main content
Docs

Documentation

Everything you need to integrate CompanyLens into your application or AI agent.

Rate limits & quotas

Limits are enforced per API key. Exceeding either the monthly or daily limit returns a 429 RATE_LIMITED response.

REST API

PlanMonthly requestsDaily limitPrice
Free50050£0
API Starter5,000UnlimitedSee pricing
API Pro25,000UnlimitedSee pricing
API Business100,000UnlimitedSee pricing

Monthly quotas reset on the first of each month at 00:00 UTC. Daily caps reset at 00:00 UTC every day.

MCP server

PlanQueriesResetsPrice
Free100 / monthMonthly£0
MCP Pro2,000 / dayDaily£29/mo — see pricing

Free MCP quota resets on the first of each month at 00:00 UTC. MCP Pro daily quota resets at 00:00 UTC every day.

Agent Coming soon

Agent plans are coming soon. The limits below reflect the planned configuration at launch. Free plan will enforce a daily cap; paid plans will enforce a monthly quota with no daily limit.

PlanMonthly queriesDaily limitPrice
FreeUnlimited50£0
Agent Starter10,000Unlimited£99/mo — see pricing
Agent Pro50,000Unlimited£299/mo — see pricing

Handling 429 responses

When you exceed your limit, the API responds with a 429 and a Retry-After header containing the number of seconds until your quota resets.

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

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Daily request quota exceeded. Resets at 00:00 UTC.",
    "correlationId": "req_01j8x4k2m9n..."
  }
}

Always read the Retry-After value rather than hardcoding a backoff duration — the value differs between monthly and daily limit exhaustion.

Monitoring usage

Current usage is visible in Dashboard → Usage. Usage data is updated in near-real time.

To avoid hitting limits unexpectedly, implement a counter in your application and check the Retry-After header on every 429 rather than assuming a fixed window.

Need higher limits? See all plans → For error code details, see the Errors reference →