Public API Documentation > General > Errors


400 Errors

The API returns errors in JSON format along with HTTP 40x status codes.

Error Fields

Key Description
type Error type.
message Humanly readable error message.
detail Additional detail specific to an error type.


An access denied error.

  "type" : "auth_error",
  "message" : "The access token is invalid or has expired."

An artist not found error.

  "type" : "other_error",
  "message" : "Artist Not Found"

A parameter validation error.

  "type" : "param_error",
  "message" : "Email can't be blank, Email is invalid, Password can't be blank.",
  "detail" : {
    "email" : ["can't be blank", "is invalid"],
    "password" : ["can't be blank"]

429 Errors

The API will return an HTTP 429 Too many requests error when your client is over the rate limit. See Rate Limiting for more information.

500 Errors

Internal server errors in the 50x range are not expected. Please report any 50x errors.

401 Broadway

The API has an easter egg, we'd love it for you to find it! You can get 401 Broadway, which is the address of the Artsy HQ in NYC, instead of 401 Unauthorized. Happy hunting.