Errors

Errors returned from API endpoints will typically have the following format.

{
  "statusCode": 400,
  "message": "BadRequest",
  "data": null,
  "errors": null
}

Error Schema

AttributeTypeDescription
statusCodeIntegerStandard HTTP response code.
messageStringA human-readable message providing more details about the status code.
dataStringAny data returned, typically null.
errorsArray of StringsAn array of human-readable error messages, if available (null otherwise).

HTTP Status Codes

Status CodeMessageDescription
200 - OKSuccessEverything worked as expected.
400 - BAD REQUESTBad RequestThe request was not accepted, likely due to missing a required parameter or incorrect syntax.
401 - UNAUTHORIZEDUnauthorizedA valid authorization token was not included in the request header.
403 - FORBIDDENForbiddenYour account is not configured to allow access to the requested API endpoint.
404 - NOT FOUNDNot FoundThe requested resource does not exist.
405 - METHOD NOT ALLOWEDMethod Not AllowedA request method is not supported for the requested endpoint. For example, a GET request on a form that requires data to be presented via POST, or the request was made using HTTP instead of HTTPS.
500 - INTERNAL SERVER ERRORInternal Server ErrorSomething went wrong on our end.