Skip to main content
The Person API enforces two types of limits: a per-request item cap and a per-minute throughput limit. Both are checked on every request before processing begins.

​
Limits

LimitValue
Max items per request100
Max items per minute600 (paid) / 5 (trial)
Concurrent requestsNo strict limit
The per-minute limit depends on the account type: 600 items/min for paid accounts, 5 items/min for trial accounts.

​
Exceeding the Limits

More than 100 items in a single request — returns HTTP 406: 
{ "error": "Maximum 100 items are allowed in one request" }
Per-minute limit exceeded — returns HTTP 429: 
{ "error": "Limit of 600 items per minute is exceeded" }
Retry logic with exponential backoff should be implemented to handle 429 responses gracefully.

​
Examples

  • 6 requests × 100 items = 600 items/min ✓
  • 600 requests × 1 item = 600 items/min ✓
  • 7 requests × 100 items = 700 items/min ✗ → 429