Skip to main content
Echo Zero REST responses use a consistent envelope. Successful calls return { "success": true, "data": ... }. Errors return appropriate HTTP status codes with structured error bodies.

​
Common statuses

StatusMeaning
400Validation error or malformed request
401Missing or invalid API key / bearer token
403Authenticated but insufficient scope or permission
404Resource not found
429Rate limit exceeded — check Retry-After
5xxServer error — retry with backoff

​
Rate limits

Authenticated requests include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers. Tiers: free (60 req/min), standard (300 req/min), premium (1000 req/min).
A complete error code catalog mapped to MCP error types will be added in a follow-up update.