Common Errors

Status code map

Code	Meaning
400	Invalid request body or parameters
401	Missing/invalid credentials or token
403	Request understood but not allowed for current subscription state
404	Route or resource not found
429	Monthly request quota exceeded
500	Server-side error
502	Invalid, refused, incomplete or unsupported model output
503	Provider temporarily unavailable or retries exhausted
504	Analysis attempt/pipeline timed out

Frequent examples

400

• Input text cannot be empty
• Input exceeds 50,000 characters
• Missing refresh token

401

• Missing or invalid Authorization header
• Invalid token
• Invalid credentials

403

• Subscription suspended. Please contact support or update payment.
• Subscription cancelled. Please resubscribe to continue using the API.

429

• Monthly user request limit reached
• Monthly IP request limit reached

502 / 503 / 504

• invalid_model_output
• provider_unavailable
• analysis_timeout

Client-side troubleshooting checklist

1. Confirm you are using the correct base URL and route.
2. Confirm Authorization: Bearer <access_token> is present for protected routes.
3. Validate JSON shape and required fields.
4. Keep input_text within 50,000 characters.
5. Show sanitized failure messages. The API already retries transient provider errors once per category; a new request may consume quota. The website does not automatically resubmit analysis failures.