Skip to main content

API 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
  • Codes in the 5xx range indicate an error with Metronome's servers (these are rare)

Every 4XX error uses this application/json format:

"message": "Descriptive error text"

The table lists the most common HTTP status codes returned by the Metronome API, along with a possible solution.

CodeMeaningDescriptionPossible solution
200OKEverything worked as expectedN/Athe 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
Metronome logoMetronome logo