Skip to main content

​
Rate Limits

VeriflowAPI enforces rate limits to ensure fair access and system stability for all customers.

​
Monthly verification quotas

Each plan includes a monthly verification quota. This is the total number of /v1/verify calls you can make per billing month.
PlanMonthly verificationsOverage
Developer500Contact support
Production5,000$0.08 per additional check
Scale50,000$0.06 per additional check
EnterpriseUnlimitedIncluded

​
Per-minute rate limits

In addition to monthly quotas, per-minute rate limits prevent burst traffic from affecting system stability.
PlanRequests per minute
Developer10
Production60
Scale300
EnterpriseCustom

​
Rate limit headers

Every API response includes headers showing your current usage: 
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4873
X-RateLimit-Reset: 1740873600
X-RateLimit-Minute-Limit: 60
X-RateLimit-Minute-Remaining: 47
HeaderDescription
X-RateLimit-LimitYour monthly verification quota
X-RateLimit-RemainingVerifications remaining this month
X-RateLimit-ResetUnix timestamp when your monthly quota resets
X-RateLimit-Minute-LimitYour per-minute limit
X-RateLimit-Minute-RemainingRequests remaining in current minute

​
Handling rate limit errors

When you exceed your per-minute limit, you will receive a 429 response: 
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Per-minute rate limit exceeded. Your limit is 60 requests per minute.",
    "retry_after": 23
  }
}
The retry_after field tells you how many seconds to wait before retrying.

​
Implementing retry logic — Python

import requests
import time

def verify_with_retry(api_key, payload, max_retries=3):
    for attempt in range(max_retries):
        response = requests.post(
            "https://api.veriflowapi.com/v1/verify",
            headers={
                "Authorization": f"Bearer {api_key}",
                "Content-Type": "application/json"
            },
            json=payload
        )

        if response.status_code == 429:
            retry_after = response.json().get('error', {}).get('retry_after', 60)
            print(f"Rate limited. Waiting {retry_after} seconds...")
            time.sleep(retry_after)
            continue

        return response.json()

    raise Exception("Max retries exceeded")

​
Bulk verification

If you need to verify large batches of providers, use the bulk endpoint rather than making individual requests in a loop. This is more efficient and counts against your quota the same way. 
POST https://api.veriflowapi.com/v1/verify/bulk
Accepts an array of up to 100 providers per request. Available on Production, Scale, and Enterprise plans. 
{
  "providers": [
    { "first_name": "Sarah", "last_name": "Chen", "state": "CA", "npi": "1234567890" },
    { "first_name": "James", "last_name": "Park", "state": "TX", "npi": "0987654321" }
  ]
}