Home/API/HTTP Status Codes
API Cheat Sheet Wiki

HTTP Status Codes cheat sheet

Lookup common API status codes and what clients should do next.

Quick lookup

200 OKSuccessful response. Confirm payload shape and caching behavior.
201 CreatedSuccessful response. Confirm payload shape and caching behavior.
204 No ContentSuccessful response. Confirm payload shape and caching behavior.
400 Bad RequestClient-side request, auth, permission, validation, or quota problem.
401 UnauthorizedClient-side request, auth, permission, validation, or quota problem.
403 ForbiddenClient-side request, auth, permission, validation, or quota problem.
404 Not FoundClient-side request, auth, permission, validation, or quota problem.
409 ConflictClient-side request, auth, permission, validation, or quota problem.
422 Unprocessable ContentClient-side request, auth, permission, validation, or quota problem.
429 Too Many RequestsClient-side request, auth, permission, validation, or quota problem.
500 Internal Server ErrorServer, proxy, upstream, or temporary provider problem.
502 Bad GatewayServer, proxy, upstream, or temporary provider problem.
503 Service UnavailableServer, proxy, upstream, or temporary provider problem.

Common mistakes

  • Debugging the client before checking the raw request and response
  • Ignoring headers that explain cache, auth, or rate limits
  • Treating browser CORS failures as generic API downtime
  • Logging tokens or webhook secrets while troubleshooting

Online tools