{
  "status": 422,
  "error": "Unprocessable Entity",
  "code": "validation_errors",
  "error_details": {
    "code": [
      "value_is_mandatory"
    ]
  }
}
The Lago API uses standard HTTP response codes to clearly indicate the result of each API request:
  • 2xx: Success - The request was processed successfully.
  • 4xx: Client Error - There was an issue with the request, such as missing parameters, invalid input, or unauthorized access.
  • 5xx: Server Error - An error occurred on Lago’s side while processing the request.
For some 4xx errors, the response body will include additional information to help you understand and resolve the specific problem.
{
  "status": 422,
  "error": "Unprocessable Entity",
  "code": "validation_errors",
  "error_details": {
    "code": [
      "value_is_mandatory"
    ]
  }
}

Error fields

status
number
required
The HTTP status code.
error
string
required
A generic error message.
code
string
A generic error code representing the type of error.
provider.code
string
The code of the payment provider that caused the error when applicable.
error_details
object
An object containing the error details. It usually maps the field names that caused the error to an array of error messages/codes.For specific errors, such as a payment provider error, the error_details may include other fields.