Errors

The RESTful API for matteroTM employs the use of the HTTP Status Codes listed below, to indicate the success or failure for a particular request. Generally speaking, 2xx indicates success and are ideal. Codes in the 4xx range indicate that not all information required has been provided, and codes in the 5xx range indicate issues on the end of matteroTM.

Code Summary Description
200 Ok The request was successful with a body in the response.
204 No Content The request was successful, no body in response.
400 Bad Request The request failed validation checks.
401 Unauthorized Failed authentication check.
402 Payment Required Payment is required to use this endpoint.
403 Forbidden Failed authorization check.
404 Not Found Either couldn't find the endpoint or the query's entity.
415 Unsupported Media Type Incorrect body format, matteroTM only accepts application/json mime-types.
429 Too Many Requests You hit our rate limiter, spread out your requests.
500 Internal Server Error An unexpected error occured on our end.
502 Bad Gateway The server was acting as a gateway or proxy and received an invalid response from the upstream server.
503 Service Unavailable The server cannot handle the request (because it is overloaded or down for maintenance). Generally, this is a temporary state.
504 Gateway Timeout The server was acting as a gateway or proxy and did not receive a timely response from the upstream server.