Error Codes

The MoneyLine API uses conventional HTTP status codes to indicate the outcome of a request. All errors return a consistent JSON format so you can handle them predictably in your application.

Error Response Format

Every error response includes a success flag set to false along with an error object containing the HTTP status code and a human-readable message:

Error structure
{
  "success": false,
  "data": null,
  "meta": {
    "requestId": "ml_req_ab12cd34ef56"
  },
  "error": {
    "message": "Descriptive error message here.",
    "statusCode": 400
  }
}

HTTP Status Codes

Below is a complete list of error codes the API may return:

CodeStatusDescription
400Bad RequestInvalid query parameters or missing required fields
401UnauthorizedMissing or invalid API key
403ForbiddenThe request is authenticated but blocked from a private or admin-only resource
404Not FoundThe requested resource does not exist
429Too Many RequestsPer-minute rate limit exceeded or monthly credits exhausted with auto-upgrade disabled
500Internal Server ErrorSomething went wrong on our end