Skip to main content
All Tuteliq API errors return a consistent JSON structure with a machine-readable 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 the VERIFY_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.

SDK Error Handling

All Tuteliq SDKs throw typed error objects that you can catch and inspect: