Status Code and Errors

Status Codes and Errors in Anduin's public API

General Knowledge

Anduin adheres to standard HTTP response codes to communicate the success or failure of an API request. As a general guide:

  • Status codes in the 2xx range signify success.
  • Status codes in the 4xx range denote errors resulting from provided information (e.g., missing required parameters, failed charges, etc.).
  • Status codes in the 5xx range indicate errors occurring on Anduin's servers.

Certain 4xx errors, which can be programmatically addressed, come with an associated error code that succinctly explains the reported issue. For example, a 400 Bad Request error might include an error message such as orderType: Invalid, providing specific details about the nature of the error for automated handling."

Common Status Codes

CodeDescription
200 - OKEverything worked as expected.
400 - Bad RequestThe request was unacceptable, often due to missing a required parameter.
401 - UnauthorizedNo valid API key provided.
402 - Request FailedThe parameters were valid but the request failed.
403 - ForbiddenThe API key doesn't have permissions to perform the request.
404 - Not FoundThe requested resource doesn't exist.
409 - ConflictThe request conflicts with another request (perhaps due to using the same idempotent key).
429 - Too Many RequestsToo many requests hit the API too quickly. We recommend an exponential backoff of your requests.
500, 502, 503, 504 - Server ErrorsSomething went wrong on Anduin Server.