Common API HTTP Status Codes

Ryan Panning edited this page May 5, 2015 · 4 revisions

Common API HTTP Status Codes

HTTP Status Codes are a fundamental concept of REST and the web in general. You should familiarize yourself with all of them, but those listed here are every-day codes that you should probably commit to memory.

2xx: Success

  • 200 OK -- Everything is fine, I'm returning what you asked for.
  • 201 Created -- I've created the resource you submitted

3xx: Redirects

  • 301 Moved Permanently -- Anything maintaining links to this resource should update the links to the new location
  • 302 Found -- Temporarily available at the new location

4xx: Client Error

  • 400 Error -- General error condition, such as malformed input data
  • 401 Unauthorized -- You need to identify yourself before the request will be able to continue
  • 403 Forbidden -- You have been identified but do not have permission to access this resource or run the requested action
  • 404 Not Found -- The requested resource does not exist
  • 405 Not Allowed -- The requested verb is not allowed for this resource

5xx: Server Error

  • 500 Error -- General or Unkown error
  • 503 Service Unavailable -- Usually indicates app server or database is unavailable
Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.