Standard Rate Limits
Average API Response Times
Average response time per request. Unless otherwise noted (for example, the 1,000-number batch row), times are measured for a single phone number. These are averages measured by third-party monitoring services. Outliers will exist that are both faster and slower.HTTP Method Requirements
Retry Example
You must plan what your system will do in the event of a network or service outage. Our recommendation is to implement retries with exponential backoff.Best Practices
Batch Your Requests
Batch Your Requests
Instead of making 100 requests with 1 number each, make 1 request with 100
numbers.
Implement Retry Logic
Implement Retry Logic
If you receive a 5xx response, wait and retry with exponential backoff.
Cache Results
Cache Results
Cache scrub results to avoid re-checking the same numbers unnecessarily.
Plan for Outages
Plan for Outages
Consider what your system will do in the event of a network or service
outage. Implement retry logic with exponential backoff and have a fallback
plan for when the API is unavailable.
Use SFTP for Very Large Batches
Use SFTP for Very Large Batches
For very large batches of phone numbers where real-time checking is not
needed, consider using SFTP file upload instead of the API. This is more
efficient for processing millions of records.