Cheatsheet
← All cheat sheets

HTTP status codes

What the number a website or API sends back means, and when to use each one.

1xx: hold on

Go ahead and send the rest of the request
Switching to another protocol, e.g. WebSocket
Start loading these files while the page is prepared

2xx: success

It worked; here is the result
Something new was made (after POST)
Received; it will be done later
It worked; nothing to send back (e.g. after DELETE)
Part of a file, for resumable downloads and video

3xx: look elsewhere

The page has a new address for good; search engines follow
Temporary redirect
Go to another page, e.g. after submitting a form
Your saved copy is still current
Temporary, and keep the same method (POST stays POST)
Permanent, and keep the same method

4xx: problem with the request

The request is malformed or missing something
Not logged in, or the login has expired
Logged in, but not allowed to do this
Nothing at this address
E.g. POST where only GET works
The request took too long to arrive
Clashes with the current state, e.g. a duplicate
It existed but was removed for good
The upload is too big
Wrong format, e.g. not JSON
An old April Fools’ joke; not used for real
Readable, but the values don’t pass checks
Slow down: rate limit reached

5xx: problem on the server

Something broke on the server
The server can’t do this at all
A server in between got a bad answer from the next one
Down for maintenance or overloaded; try again later
A server in between waited too long for the next one
Something not working?

Send feedback

What is it?

The page you’re on, your browser and your screen size are sent along to help us fix it. Never your files or what you typed into the tool.