code and a human-readable message:
Error Codes
Authentication (AUTH_1xxx)
Rate Limiting (RATE_2xxx)
Validation (VAL_3xxx)
Service (SVC_4xxx)
Not Found (NF_5xxx)
Analysis (ANALYSIS_6xxx)
Subscription (SUB_7xxx)
GDPR (GDPR_8xxx)
Verification (VERIFY_11xxx)
Age and identity verification return codes in theVERIFY_11xxx range. They are also listed, with guidance, on Age and identity verification.
Verification allowance (VERIFY_110xx)
On a plan with a monthly verification allowance, a new verification is checked against that allowance before any work starts. See Verification plans with a monthly allowance.WebSocket (WS_10xxx)
Retry Strategy
Not all errors should be retried. Here’s a guide:Exponential backoff example
The Node.js and Python SDKs have built-in retry logic. Set
retries: 2 (Node.js) or retries=2 (Python) in the client constructor to enable automatic retries with exponential backoff.