Skip to main content

​
Error Codes & Responses

The eStream uses consistent HTTP status codes for all responses.
Each code includes a clear message and optional error_code field for advanced integrations.

​
✅ Success Responses

CodeMeaningExampleNotes
200OKRequest processed successfully.Most GET endpoints.
201CreatedA new resource has been created.Used for POST /recruitments
202AcceptedRequest queued or batch accepted.Used for /batch calls.

​
⚠️ Client Error Responses

CodeMeaningExample MessageResolution
400Bad RequestInvalid or missing parameters.Check JSON format or query parameters.
401UnauthorizedInvalid or expired token.Log in again using /auth/login.
403ForbiddenAccess denied.Verify IP allowlist or role permissions.
404Not FoundResource not found.Ensure the requested ID or path exists.
409ConflictDuplicate or conflicting record.Adjust your request payload.

​
🚨 Server Error Responses

CodeMeaningExample MessageResolution
429Too Many RequestsRate limit exceeded.Wait before retrying or reduce call frequency.
500Internal Server ErrorUnexpected error occurred.Contact support with the request ID.
503Service UnavailableAPI temporarily down.Retry after a few minutes.

​
🧾 Example JSON Response

​
Error Example

{
  "status": 401,
  "error": "Unauthorized",
  "message": "Invalid or expired token"
}