Ada’s API uses conventional HTTP response codes to indicate the success or failure of API requests. In general:

  • Codes in the 2xx range indicate success
  • Codes in the 4xx range indicate errors caused by the request
  • Codes in the 5xx range indicate errors on our servers

HTTP Status Code Summary

Status CodeError TypeDescription
400Bad RequestThe request was malformed or contained invalid parameters
401UnauthorizedAuthentication credentials were missing or invalid
403Authorization ErrorThe authenticated user lacks permission to access the resource
404Not FoundThe requested resource doesn’t exist
409Duplicate ResourceA resource with the same identifier already exists
413Content Too LargeThe request payload exceeds size limits
422Unprocessable ContentThe request syntax was valid but the content cannot be processed
429Too Many RequestsRate limit exceeded - too many requests in a given time period
500Internal Server ErrorSomething went wrong on our servers

Error Response Format

All error responses follow this format:

1{
2 "errors": [
3 {
4 "type": "error_type",
5 "message": "Human readable message",
6 "details": "Optional, additional error details"
7 }
8 ]
9}