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

Frequent examples

400

• Input text cannot be empty
• Input exceeds maximum of 15000 characters. Received: ...
• 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

500

• analysis_parsing_error

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 15,000 characters.
5. Implement retry/backoff handling for 429 and transient 500 errors.