Skip to main content


AniAPI uses conventional HTTP response codes to indicate the success or failure of an API request. As a summary:

  • 2xx range indicates success
  • 4xx range indicates an error regarding the information provided (e.g., a required parameter missing, a resource not found, etc)
  • 5xx range indicates an error with AniAPI's server

HTTP errors are returned inside the HTTP response header, instead API errors are returned inside the HTTP response body!

API errors#

When an API request gets an HTTP 200 status code as a response, it could mean that the API response contains an error. These are the possible errors you can have:

200 - OKEverything worked as expected
400 - Bad requestThe request was unacceptable, often due to missing a required parameter
401 - UnauthorizedThe user is not able to authenticate
403 - ForbiddenThe user doesn't have permissions to perform the request
404 - Not foundThe requested resource doesn't exist
429 - Too many requestsToo many requests hit the API too quickly from the same origin
500 - Server errorSomething went wrong on AniAPI's end

Handling errors#

We recommend to focus on HTTP errors just for Authentication or network problems.