API Documentation

Billing Rules

• Only successful calls are billed. If the API returns a non-2xx status code (error), no credits are deducted.
• Per-result billing (people_search) charges based on the actual number of results returned, not the total available.
• Per-person/email billing (email_finding, email_verification) charges based on the number of items in your <code>data</code> array.
• Inquiry endpoints are always free. Check results as many times as you want.

Checking Your Usage

# Current month
curl https://api.richapi.ai/api/v1/usage \
  -H "x-api-key: YOUR_API_KEY"

# Specific month
curl "https://api.richapi.ai/api/v1/usage?month=2026-03" \
  -H "x-api-key: YOUR_API_KEY"

Response:

{
  "month": "2026-03",
  "total_credits": 42.5,
  "apis": {
    "enrich_profile": {
      "calls": 25,
      "credits": 25
    },
    "people_search": {
      "calls": 5,
      "credits": 17.5
    }
  }
}

Rate Limits

Each endpoint has a per-customer monthly quota of <strong>100,000 calls</strong>. If you exceed this limit, the API returns a <code>429</code> status code.

{
  "error": "Monthly quota exceeded",
  "api": "enrich_profile",
  "limit": 100000,
  "current": 100000
}