Rate Limits

Captain Data applies one customer-facing rate limit on the v1 API: your subscription plan (requests per second and per minute). Understanding these limits helps you design efficient integrations and avoid interruptions. Rate limits are applied at:

API endpoints — per-second and per-minute caps on requests, based on your plan tier
Daily credit quotas — total daily usage allowance based on your plan (separate from rate limits)

Each plan includes a daily credit quota consumed by billed API calls across your workspace. For how individual endpoints are priced, see Credit costs. Rate limits control request throughput; they are not the same as credits.

Plan Tiers and Rate Limits

Your rate limits are determined by your plan tier, which is based on your monthly credit allocation:

Plan Tier	Monthly Credits	Max Requests/Second	Max Requests/Minute
Trial	Up to 1,000	1	60
Bronze	1 - 10,000	2	120
Silver	10,001 - 100,000	10	600
Gold	100,001 - 500,000	10	600
Platinum	500,001 - 2,000,000	20	1,200
Diamond	2,000,001 - 20,000,000	20	1,200
Titanium	20,000,001 - 50,000,000	40	2,400

Check your subscription page in Captain Data to see your current plan tier and monthly credit allocation.

Capacity Examples

Assuming an average request duration of 2-3 seconds:

Plan Tier	Estimated Daily Capacity	Example Use Case
Trial	~86,400 requests/day	Small-scale testing
Bronze	~172,800 requests/day	Individual prospecting
Silver / Gold	~864,000 requests/day	Team sales operations
Platinum / Diamond	~1,728,000 requests/day	Large-scale enrichment
Titanium	~3,456,000 requests/day	Enterprise automation

Example: With a Silver or Gold tier plan (600 requests/minute), you can:

Enrich ~864,000 people profiles per day
Process ~36,000 profiles per hour
Handle ~600 concurrent enrichment requests

Quotas

Rate limits for quota and billing data retrieval via /quotas:

Plan Tier	Max Requests/Second	Max Requests/Minute
Trial	< 1	5
Bronze	< 1	10
Silver	1	50
Gold	1	50
Platinum	1	75
Diamond	1	75
Titanium	2	100

Best Practices

Optimizing for Rate Limits

Implement Exponential Backoff: When you hit the plan rate limit, wait before retrying with increasing delays.
Monitor Your Usage: Track your API consumption to stay within limits.
Space concurrent workers: Stay under your plan’s requests/second, not only requests/minute.

Handling Rate Limit Errors

When you exceed the subscription plan rate limit, you receive HTTP 429 Too Many Requests with this body (also reflected in response headers when present):

{
  "error": {
    "code": 429,
    "status": "Too Many Requests",
    "details": {
      "Retry-After": "60",
      "X-RateLimit-Limit": "2",
      "X-RateLimit-Reset": "1754402101",
      "X-RateLimit-Type": "/v1/people/enrich"
    },
    "message": "Rate limit exceeded (/v1/people/enrich)"
  }
}

Field	Meaning
`Retry-After`	Seconds to wait before retrying
`X-RateLimit-Limit`	Cap that was hit (for the window in effect)
`X-RateLimit-Reset`	Unix timestamp when the window resets
`X-RateLimit-Type`	Endpoint path the limit applies to

Use Retry-After when present; otherwise apply exponential backoff.

This plan-limit response uses a nested error object. Most other API failures use the standard error_label / error_scope / error_ref shape. Treat a nested error.code === 429 as a plan rate limit. A flat body with status_code: 429 and error_label: "GENERIC_ERROR" is a transient server-side failure — retry with backoff, and do not expect window or provider details in params.

Monitoring and Alerts

Track your rate limit usage through:

API response headers (Retry-After, X-RateLimit-*) on plan-limit responses
Dashboard analytics
Webhook notifications for quota warnings

Getting Help

If you consistently hit rate limits or need higher limits:

Review your implementation design for optimization opportunities
Consider upgrading your plan for higher limits
Contact support for custom enterprise solutions

For detailed information about your current plan’s limits, check your workspace dashboard or contact our support team.

Getting Started

People

Companies

Workspace

Plan Tiers and Rate Limits

Capacity Examples

Quotas

Best Practices

Optimizing for Rate Limits

Handling Rate Limit Errors

Monitoring and Alerts

Getting Help

​Plan Tiers and Rate Limits

​Capacity Examples

​Quotas

​Best Practices

​Optimizing for Rate Limits

​Handling Rate Limit Errors

​Monitoring and Alerts

​Getting Help

Plan Tiers and Rate Limits

Capacity Examples

Quotas

Best Practices

Optimizing for Rate Limits

Handling Rate Limit Errors

Monitoring and Alerts

Getting Help