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

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:
Per-minute limit exceeded — returns HTTP 429:
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