Developer

HTTP status codes

Look up an HTTP code: meaning and when to use it.

  • Instant
  • Free
  • Private (processed locally)
  • No sign-up
200OK
Success

The request succeeded.

201Created
Success

A resource was created.

202Accepted
Success

Accepted, processing later.

204No Content
Success

Success, no content returned.

206Partial Content
Success

Partial content (range request).

301Moved Permanently
Redirection

Moved permanently to a new URL.

302Found
Redirection

Temporary redirect.

304Not Modified
Redirection

Not modified, use your cache.

307Temporary Redirect
Redirection

Temporary redirect, method kept.

308Permanent Redirect
Redirection

Permanent redirect, method kept.

400Bad Request
Client error

Malformed request from the client.

401Unauthorized
Client error

Authentication required or failed.

403Forbidden
Client error

Access forbidden, insufficient rights.

404Not Found
Client error

Resource not found.

405Method Not Allowed
Client error

HTTP method not allowed here.

409Conflict
Client error

Conflict with the current state.

410Gone
Client error

Resource permanently gone.

418I'm a teapot
Client error

I’m a teapot (April Fools’ joke).

422Unprocessable Entity
Client error

Syntactically valid but unprocessable.

429Too Many Requests
Client error

Too many requests, slow down.

500Internal Server Error
Server error

Internal server error.

501Not Implemented
Server error

Functionality not implemented.

502Bad Gateway
Server error

Invalid response from upstream.

503Service Unavailable
Server error

Service unavailable (overload, maintenance).

504Gateway Timeout
Server error

Timeout from an upstream server.

The HTTP code dictionary, a search away

When a web request fails, the server returns a three-digit code. This tool gathers and explains them: type a number (404) or a phrase (“not found”), filter by class, and read each code’s meaning and proper use.

  1. Search

    By number, by phrase, or by class (“4” for the 4xx).

  2. Read the card

    Code, official phrase, category and description.

  3. Pick the right code

    For your API, redirect or error page.

The four big families

ClassMeaningExamples
2xxSuccess200 OK, 201 Created, 204 No Content
3xxRedirection301 Moved, 302 Found, 304 Not Modified
4xxClient error400, 401, 403, 404, 429
5xxServer error500, 502, 503, 504

Debugging reflex: the first digit tells you the side. A 4xx is to fix on the request (URL, rights, format); a 5xx on the server (code, configuration, overload).

Frequently asked questions

What do the 2xx, 3xx, 4xx, 5xx classes mean?

The first digit gives the category: 2xx = success, 3xx = redirection, 4xx = client-side error (your request), 5xx = server-side error. A glance at the first digit already tells you whose problem it is.

What’s the difference between 401 and 403?

401 (Unauthorized) means “identify yourself”: authentication is missing or failed. 403 (Forbidden) means “I know who you are, but you’re not allowed”. The first is fixed by logging in, the second is not.

When do I use 301 rather than 302?

301 (Moved Permanently) for a definitive move: search engines transfer ranking to the new URL. 302 (Found) for a temporary move: the old URL stays the reference. Getting it wrong hurts SEO.

Does code 418 really exist?

Yes! 418 “I’m a teapot” comes from a 1998 April Fools’ joke (a coffee-pot protocol). It has no serious use but became a cult joke, and some servers return it for silly requests.