Skip to main content

General Error Pattern & Codes

Description

All HPM services use a standardized error structure compatible with the Finrota API architecture.

Common fields:

  • statusCode – Code representing the status of the operation (e.g., 200, 400, 401, 500, etc.)

  • message – Human-readable summary message.

  • errors / exceptions – Detailed list of errors or exception information (if any).

Common HTTP Codes

CodeMeaning
200OK → Operation successful, result returned.
201Created → A new resource was created (not typical for HPM).
400Bad Request → Required field missing, format error, etc.
401Unauthorized → Token missing or invalid.
403Forbidden → No service permission/license.
404Not Found → Related record/resource not found.
409Conflict → Conflicting state (e.g., scenarios related to the same clientOrderReference rule, etc.).
422Unprocessable Entity → Validation errors (field-based).
429Too Many Requests → Minute/request limits exceeded.
500Internal Server Error → General server error.
503Service Unavailable → Service temporarily unavailable.