Skip to main content

Error Handling

This service uses consistent error handling patterns for all API endpoints. Errors are returned as JSON objects with a statusCode, path, and error field.

Common Error Types​

  • 400 Bad Request: Invalid input, missing required fields, or failed validation.
  • 404 Not Found: Resource does not exist.
  • 500 Internal Server Error: Unexpected server error.

Example Error Response​

{
  "statusCode": 400,
  "error": ["description of the rror"],
  "requestId": "72e32108-6260-45e9-bb12-325fe3b61e42",
  "path": "path to the endpoint",
  "timestamp": "2025-11-19T16:32:57.915Z"
}