Students & new developers

Build an HTTP status-code explorer

You have probably met 404 Not Found. Every website answers with a code like it. See what each one means, then build your own explorer in one HTML file.

Choose a situation to see what the website answers. Then select any code below to read about it.

Ask a website for something. See what it answers.

Your browser

asksGET /recipes

200 OKthe website answers

The website

It worked. Here is what you asked for.

Who fixes it
Nobody. Nothing is wrong.
Try again?
Not needed
How often you meet it
Often

All 63 codes

63 codes

Met often

1xx Informational The conversation is still going.

2xx Success It worked.

3xx Redirection Look somewhere else.

4xx Client errors The request was wrong.

5xx Server errors The website failed.

Every code in the IANA registry is here, including a few that are reserved, deprecated or obsolete. Each card says which.

Complete HTTP code reference
CodeNameClassIn plain EnglishExampleWho fixes itTry again
100ContinueInformationalGo ahead and send the rest of your request.A program asks before uploading a large file, and the server says to go ahead.NobodyNot needed
101Switching ProtocolsInformationalThe server agrees to switch to a different way of talking.A chat page upgrades its connection to a WebSocket so that messages arrive instantly.NobodyNot needed
102ProcessingInformationalThe server has the request and is still working on it.A file server takes a long time over a big copy and says it has not forgotten you.NobodyNot needed
103Early HintsInformationalHere is a head start: begin loading these files while the page is prepared.A site tells the browser which fonts and styles to fetch before the page itself arrives.NobodyNot needed
200OKSuccessIt worked. Here is what you asked for.You open a page and it loads.NobodyNot needed
201CreatedSuccessIt worked, and something new was made.You post a comment or create an account.NobodyNot needed
202AcceptedSuccessThe request was taken in and will be dealt with later.You ask for a large report and are told it will be emailed when it is ready.NobodyNot needed
203Non-Authoritative InformationSuccessIt worked, but a go-between changed the reply on the way.A proxy rewrites part of a page before passing it on to you.NobodyNot needed
204No ContentSuccessIt worked, and there is nothing to send back.You save a setting and the page stays as it is.NobodyNot needed
205Reset ContentSuccessIt worked. Clear the form you just sent.A data-entry screen empties its boxes, ready for the next record.NobodyNot needed
206Partial ContentSuccessHere is the part you asked for, not the whole thing.You skip to the middle of a video, or a download carries on from where it stopped.NobodyNot needed
207Multi-StatusSuccessSeveral things were asked for at once, and each has its own result inside.A file-sharing program moves ten files and reports on each one.NobodyNot needed
208Already ReportedSuccessThese items were already listed earlier in this reply.A folder that appears twice in a file-server listing is described only once.NobodyNot needed
226IM UsedSuccessHere are only the changes since the copy you already have.A feed reader receives just the new entries, not the whole feed again.NobodyNot needed
300Multiple ChoicesRedirectionThere is more than one version. Pick one.A document is offered in several formats or languages.The requesterAfter choosing one
301Moved PermanentlyRedirectionThis has a new address for good. Use the new one from now on.A site changes its name and sends old links to the new pages.The browserAutomatic
302FoundRedirectionThis is somewhere else for now. Keep using the old address.After signing in, you are sent back to the page you came from.The browserAutomatic
303See OtherRedirectionYour request was handled. Fetch the result from this other address.You submit an order form and land on a confirmation page.The browserAutomatic
304Not ModifiedRedirectionNothing has changed. Use the copy you already have.You revisit a page and the browser reuses the images it saved last time.NobodyNot needed
305Use ProxyRedirectionNo longer used. It once told the browser to go through a named proxy.You will not meet it: browsers stopped honoring it for security reasons.NobodyNo
306(Unused)RedirectionReserved and no longer used.It was dropped from an early version of HTTP, and the number is kept empty.NobodyNo
307Temporary RedirectRedirectionThis is somewhere else for now. Repeat exactly the same request there.A form you submit is passed to another server without losing what you typed.The browserAutomatic
308Permanent RedirectRedirectionThis has moved for good. Repeat exactly the same request at the new address.An API moves to a new address and uploads keep working.The browserAutomatic
400Bad RequestClient ErrorThe server could not understand the request.A form sends a date that is not a date, or the address contains broken characters.The requesterAfter fixing the request
401UnauthorizedClient ErrorYou need to sign in, or your sign-in was not accepted.You open your account page after your session has expired.The requesterAfter signing in
402Payment RequiredClient ErrorReserved for a future way to pay. A few services use it to say that payment is needed.An API returns it when a subscription has run out.The requesterAfter fixing the request
403ForbiddenClient ErrorThe server knows who you are and will not let you in.You are signed in as a student and try to open the teacher's gradebook.The requesterNo
404Not FoundClient ErrorNothing is at this address.You mistype a web address, or follow a link to a page that was deleted.The requesterAfter fixing the request
405Method Not AllowedClient ErrorThe address exists, but not for what you tried to do to it.A program tries to delete a page that can only be read.The requesterAfter fixing the request
406Not AcceptableClient ErrorThe server has nothing in a format you said you would accept.A program insists on XML and the service only produces JSON.The requesterAfter fixing the request
407Proxy Authentication RequiredClient ErrorYou must sign in to the proxy before it will pass your request on.An office network asks for your login before letting you onto the web.The requesterAfter signing in
408Request TimeoutClient ErrorThe server gave up waiting for you to finish sending.A weak phone signal stalls an upload halfway.The requesterYes
409ConflictClient ErrorThe request clashes with what is already there.Two people edit the same document, and the second save is refused.The requesterAfter fixing the request
410GoneClient ErrorThis was here once and has been removed for good.A shop takes down the page of a discontinued product on purpose.The requesterNo
411Length RequiredClient ErrorThe server needs to be told how much data is coming.A program uploads a file without saying how big it is.The requesterAfter fixing the request
412Precondition FailedClient ErrorA condition you attached to the request was not true.You say "save only if nobody else has changed it", and somebody had.The requesterAfter fixing the request
413Content Too LargeClient ErrorWhat you sent is bigger than the server allows.You try to upload a 2 GB video where the limit is 100 MB.The requesterAfter fixing the request
414URI Too LongClient ErrorThe address is longer than the server will read.A search form packs thousands of characters into the address.The requesterAfter fixing the request
415Unsupported Media TypeClient ErrorThe server does not accept the kind of file or data you sent.You upload a spreadsheet where only images are allowed.The requesterAfter fixing the request
416Range Not SatisfiableClient ErrorYou asked for a part that does not exist.A download tries to carry on from beyond the end of the file.The requesterAfter fixing the request
417Expectation FailedClient ErrorThe server cannot do what the request's Expect header asked.A program asks for a go-ahead before uploading, and the server does not give go-aheads.The requesterAfter fixing the request
418I'm a teapotClient ErrorA joke: the server says it is a teapot and cannot brew coffee.An April Fools' Day specification defined it in 1998, and some sites return it for fun.NobodyNo
421Misdirected RequestClient ErrorThe request reached a server that is not set up to answer for that site.A shared connection is reused for a site the server does not host.The browserYes
422Unprocessable ContentClient ErrorThe request was understood, but what it says does not make sense.A booking form sends an end date that comes before its start date.The requesterAfter fixing the request
423LockedClient ErrorThe item is locked and cannot be changed now.A colleague has a shared file open for editing.The requesterLater
424Failed DependencyClient ErrorThis step failed because an earlier step it relied on failed.A file cannot be copied because creating its folder failed first.The requesterAfter fixing the request
425Too EarlyClient ErrorThe server will not act yet on a request that might be a replayed copy.A request sent in the first instant of a secure connection is asked to wait until the connection is confirmed.The browserYes
426Upgrade RequiredClient ErrorThe server will only answer over a different protocol.A service refuses an old kind of connection and names the one to use.The requesterAfter fixing the request
428Precondition RequiredClient ErrorThe server insists that the request carries a condition.An editor must say which version it is changing, so that two people do not overwrite each other.The requesterAfter fixing the request
429Too Many RequestsClient ErrorYou have asked too many times in a short while. Slow down.A program calls a free API a thousand times in a minute.The requesterLater
431Request Header Fields Too LargeClient ErrorThe extra information sent with the request is too big.A site's cookies have grown so large that the server rejects every page.The requesterAfter fixing the request
451Unavailable For Legal ReasonsClient ErrorThe server is not allowed to show this for legal reasons.A court orders a page to be blocked in one country. The number is a nod to the novel Fahrenheit 451.NobodyNo
500Internal Server ErrorServer ErrorSomething broke on the server, and it cannot say what.A bug in the site's code crashes while building your page.The websiteLater
501Not ImplementedServer ErrorThe server does not know how to do that kind of request.A simple server receives a kind of request it was never built to handle.The websiteNo
502Bad GatewayServer ErrorA server in the middle got a broken answer from the server behind it.The site's front door is open, but the application behind it has crashed.The websiteLater
503Service UnavailableServer ErrorThe server cannot answer right now. It is overloaded or down for maintenance.Ticket sales open and far too many people arrive at once.The websiteLater
504Gateway TimeoutServer ErrorA server in the middle waited too long for the server behind it.A report takes so long to build that the front server stops waiting.The websiteLater
505HTTP Version Not SupportedServer ErrorThe server does not support the version of HTTP the request used.A very old program talks to a modern server in a version it has dropped.The requesterAfter fixing the request
506Variant Also NegotiatesServer ErrorThe server is set up wrongly: its choice between versions loops back on itself.A misconfigured site cannot decide which language version to send.The websiteNo
507Insufficient StorageServer ErrorThe server has run out of room to store what you sent.A shared drive is full when you try to save a file.The websiteLater
508Loop DetectedServer ErrorThe server found itself going round in circles and stopped.Folders on a file server link to each other in a loop.The websiteNo
510Not ExtendedServer ErrorObsolete. The server wanted the request to use an extension that was never widely adopted.You will not meet it: the experiment it belonged to was retired.NobodyNo
511Network Authentication RequiredServer ErrorYou must sign in to the network before you can reach the web.Hotel or airport Wi-Fi shows its login page first.The requesterAfter signing in

Make it your own

Build your own version.

The starter is one HTML file with no tools to install. Save it, open it in your browser, and it fetches the complete free list, draws the five bands and opens a card for any code.

Read the starter before you run it
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>HTTP status-code explorer</title>
<style>
  body { max-width: 1000px; margin: 32px auto; padding: 16px; font: 16px system-ui; color: #243b50; }
  input, button { font: inherit; padding: 12px; }
  input { max-width: 100%; box-sizing: border-box; }
  .tiles { display: grid; grid-template-columns: repeat(auto-fill, minmax(125px, 1fr)); gap: 8px; }
  .tile { border: 1px solid #aebfcd; border-top: 3px solid #426b90; border-radius: 5px; background: #f3f7fa; text-align: left; cursor: pointer; }
  .tile strong, .tile span { display: block; }
  .tile strong { font-size: 1.4rem; margin-bottom: 8px; }
  .tile span { font-size: .8rem; }
  .dimmed { opacity: .35; }
  .tile:hover, .tile:focus-visible { opacity: 1; background: #dce9f2; }
  .detail { grid-column: 1 / -1; padding: 18px; border: 1px solid #7b95a9; background: #fff; }
  .detail button { float: right; }
</style>
<h1>HTTP status-code explorer</h1>
<p>Select a tile to read what it means. ● marks the codes you meet often.</p>
<label>Find a code or phrase <input id="search" type="search"></label>
<p id="status" role="status">Loading codes…</p>
<button id="retry" hidden>Retry</button>
<main id="explorer"></main>
<script type="module">
const explorer = document.querySelector('#explorer');
const search = document.querySelector('#search');
const status = document.querySelector('#status');
const retry = document.querySelector('#retry');
const classes = ['Informational', 'Success', 'Redirection', 'Client errors', 'Server errors'];
let records = [];
let tiles = [];
let selected;
const detail = document.createElement('section');
detail.className = 'detail';
detail.hidden = true;

// Data goes into textContent, never into HTML strings.
function select(tile, record) {
  detail.remove();
  selected = tile;
  const close = document.createElement('button');
  close.textContent = 'Close';
  close.onclick = () => {
    detail.remove();
    tile.focus({ preventScroll: true });
  };
  const heading = document.createElement('h3');
  heading.textContent = `${record.Code} · ${record.Name}`;
  const meaning = document.createElement('p');
  meaning.textContent = record.PlainEnglish;
  const example = document.createElement('p');
  example.textContent = `For example: ${record.Example}`;
  const facts = document.createElement('p');
  facts.textContent = `Who fixes it: ${record.WhoFixesIt}. Try again? ${record.TryAgain}.`;
  detail.replaceChildren(close, heading, meaning, example, facts);
  // Insert after the last tile on this row, including on phones.
  const row = [...tile.parentElement.children].filter(item => item.offsetTop === tile.offsetTop);
  row.at(-1).after(detail);
  detail.hidden = false;
  detail.scrollIntoView({ block: 'nearest' });
  close.focus({ preventScroll: true });
}

function filter() {
  const query = search.value.trim().toLowerCase();
  let count = 0;
  for (const { tile, record } of tiles) {
    const match = [record.Code, record.Name, record.PlainEnglish].join(' ').toLowerCase().includes(query);
    tile.classList.toggle('dimmed', !match);
    if (match) count++;
  }
  status.textContent = `${count} of ${records.length} codes${count ? '' : ' · No matches; try another phrase.'}`;
}

async function load() {
  retry.hidden = true;
  status.textContent = 'Loading codes…';
  try {
    const response = await fetch('https://mysafeinfo.com/api/data/httpstatuscodes?format=json');
    if (!response.ok) throw new Error(`HTTP ${response.status}`);
    records = await response.json();
    explorer.replaceChildren();
    tiles = [];
    for (let family = 1; family <= 5; family++) {
      const band = document.createElement('section');
      const heading = document.createElement('h2');
      heading.textContent = `${family}xx · ${classes[family - 1]}`;
      const grid = document.createElement('div');
      grid.className = 'tiles';
      for (const record of records.filter(row => Math.floor(row.Code / 100) === family).sort((a, b) => a.Code - b.Code)) {
        const tile = document.createElement('button');
        tile.className = 'tile';
        const code = document.createElement('strong');
        code.textContent = `${record.Code}${record.Seen === 'Often' ? ' ●' : ''}`;
        const name = document.createElement('span');
        name.textContent = record.Name;
        tile.append(code, name);
        tile.onclick = () => select(tile, record);
        grid.append(tile);
        tiles.push({ tile, record });
      }
      band.append(heading, grid);
      explorer.append(band);
    }
    filter();
  } catch {
    status.textContent = 'Could not load the codes. Check your connection and try again.';
    retry.hidden = false;
  }
}
search.addEventListener('input', filter);
retry.addEventListener('click', load);
document.addEventListener('keydown', event => {
  if (event.key === 'Escape') {
    detail.remove();
    selected?.focus({ preventScroll: true });
  }
});
load();
</script>
</html>

A project brief you can finish

  1. Milestone 1: show the complete list

    Load the free JSON, sort by Code, and show each code with its Name and PlainEnglish. Keep the data separate from the function that draws it.

  2. Milestone 2: search and filter

    Search the code, name and plain-English meaning together. Add a filter for WhoFixesIt, keep keyboard focus in the control, and announce the number of matches without moving the page.

  3. Milestone 3: handle every state

    Show loading, a useful message when nothing matches, and a clear error with Retry. Check response.ok before reading the JSON: your own explorer will meet these codes too.

Stretch goals

Add your own stage: a row of situations that each show a request and its answer. Add a quiz that names a situation and asks for the code. Add a “copy code” button, or keyboard shortcuts with visible instructions.

Test a search with no matches, an offline request and a small phone. Not every code here is in everyday use: Status marks the reserved, deprecated and obsolete ones. Compare a code with the IANA registry (opens in a new tab) and the specification its card links to.

Questions

Why check response.ok?

A request that completes can still carry an error code. fetch does not fail just because a server answered 404 or 500, so your code has to look.

What should an empty search look like?

Say that nothing matched and suggest clearing the search. Do not show a network error: the list loaded fine.

Who decided what each code means?

The Internet Engineering Task Force publishes the specifications, and the Internet Assigned Numbers Authority keeps the registry of codes. Specification and SpecificationUrl point to the section that defines each one. The plain-English meanings and examples are ours.

Free in full. No Data Pass or API key needed. Opening this guide does not use your API allowance.

What each record contains

Explore the dataset and its sources. These fields are in the complete download.

FieldHow to read it
Code HTTP status number. A listed code is not necessarily a current IANA standard.
Name Short status label.
Category Status family; useful for filters and grouping.
Description Dataset explanation; check IANA and the linked standard for implementation details.
PlainEnglish What the code means, in one sentence written for students. Ours, not the specification’s.
Example An everyday situation that produces the code.
WhoFixesIt Who has to act: Nobody, The browser, The requester (the person or program that sent the request) or The website.
TryAgain Whether repeating the request can help: Not needed, Automatic, Yes, Later, After signing in, After fixing the request, After choosing one, or No.
Seen How often a web user or developer meets it: Often, Sometimes or Rarely. Our judgement.
Status Standard, Reserved, Deprecated, Unused or Obsolete, as the IANA registry and RFC 9110 class it.
Specification The document and section that define the code, as the IANA registry cites it.
SpecificationUrl A link to that section at rfc-editor.org.

Working with the download? Convert CSV to JSON, or turn a column into a list with the comma separator.

For your next project

More subjects to build with.

HTTP status codes are free in full. The Data Pass covers the rest of the catalog.

The Data Pass includes complete downloads and API access across the catalog.

Data Pass

$69one payment / 365 days

See what’s included

No account required. No automatic renewal.