Error Handling

All errors follow a consistent shape with an HTTP status code and a message field.

json

{
  "statusCode": 400,
  "message":    "Cannot link accounts to an application with status: COMPLETED",
  "error":      "Bad Request"
}

Status	Meaning	Common Cause
400	Bad Request	Missing required field, invalid value, or the application is in a terminal state.
401	Unauthorized	Missing or invalid x-api-key header.
404	Not Found	The applicationId or applicantId does not belong to your account.
429	Too Many Requests	Rate limit exceeded. /initiate and /analyze are limited to 20 requests per minute.
500	Internal Server Error	Unexpected server error. Mono API key not configured, or a downstream service failure.