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 (VRF_9xxx)

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: