Most of MODE's HTTP response codes uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, insufficient authentication, etc.). Codes in the 5xx range indicate an error with MODE's servers; these are very rare.

The most common error response is 403 indicating a general error has occurred. These error responses will be returned with the following body:

{ "reason": ERROR_CODE }

ERROR_CODE represents the error message that is returned. Some examples of error codes include: UNKNOWN_EMAIL,INVALID_USER_ID,MISSING_PARAMETERS. These error codes will help determine what needs to be done to make a successful request.

HTTP Status Code Summary

  • 200 Successful response. Everything worked as expected.
  • 201 Successful creation of the request.
  • 400 The request is invalid. Typically due to missing parameters or an invalid parameter format.
  • 401 Authorization is required. No valid auth token is provided.
  • 403 Unable to process request. These may happen for a variety of reasons. Please refer to the reason returned for more information.
  • 404 Resource not found.
  • 405 This method is not allowed.
  • 409 The request could not be completed due to a conflict with the current state of the target resource. This code is used in situations where the user might be able to resolve the conflict and resubmit the request.
  • 501, 503 Issues with MODE server. These are extremely rare.