Errors
Errors & rate limits
Every error includes a machine-readable code, a human-readable message, and a docs URL so you know exactly what to do next.
Stripe-style error responses
| Status | Code | Message |
|---|---|---|
| 401 | invalid_api_key | The API key you provided is invalid. Keys look like vfx_your_api_key, check your dashboard.https://verifex.tech/docs#authentication |
| 402 | quota_exceeded | You've used all your screens this month. Upgrade to get more.https://verifex.tech/pricing |
| 429 | rate_limit_exceeded | You've hit the rate limit. Slow down or upgrade your plan for higher limits.https://verifex.tech/docs |
| 400 | validation_error | name is required: provide the name of the person or entity to screen.https://verifex.tech/docs#screen |
| 403 | account_disabled | Your account has been disabled. Contact support for assistance.https://verifex.tech/contact |
| 500 | internal_error | An unexpected error occurred. Include the request_id when contacting support.https://verifex.tech/contact |
Rate limits
Trial accounts run at Starter rate limits and have 5 screens in total. The trial does not reset monthly.
The trial is intended for evaluation; after 5 screens, subscribe to a paid plan to keep screening. Usage and quota information is available after sign-in.
When you exceed the limit the API returns rate_limit_exceeded with a 429 status. Slow down or upgrade your plan for higher limits.