Skip to main content

Status codes

Metronome uses conventional HTTP status codes to indicate the success or failure of an API request.

  • Codes in the 2xx range indicate success.
  • Codes in the 4xx range indicate an error caused by the client request. Any 4XX error returned by Metronome will be application/json in the format below.
{
"message": "error text here"
}
  • Codes in the 5xx range indicate an error with Metronome's servers - these are rare.

Table of status codes

Below is a table of the HTTP status codes that might be returned by Metronome's API

CodeDefinitionDescriptionPossible Solution
200OKEverything worked as expectedN/A - the request was successful
400Bad RequestThe request was unacceptable, often due to malformed syntax, or a missing or malformed parameterEnsure request syntax is correct
401Invalid access tokenRequestor is unauthorized or does not have permission for this API callEnsure API token is valid
403ForbiddenRequestor does not have access to this resourceEnsure API token is valid
429Too Many RequestsToo many requests hit the API too quicklyWait and try again later
5XXServer ErrorsSomething went wrong while servicing your requestRetry your request