Status Pizza API

Free HTTP status code API with no key: every status code mapped to a pizza photograph, plus JSON giving the code's title and category. Tested example included.

No API key requiredHTTPSFree tier

Endpoint tested and returned HTTP 200 on 2026-08-21

What is the Status Pizza API?

Status Pizza maps every HTTP status code to a pizza photograph. Appending `.json` to a code returns metadata instead of the image: the code, its official title, its category, and URLs for both the framed and raw pictures.

The joke is well worn by now — HTTP status codes illustrated by animals, by food, by whatever — but the JSON variant here turns it into something mildly useful. Requesting `/404.json` gives you `"Not Found"` and `"Client error"` alongside the image URLs, which is a perfectly reasonable little lookup table for a status code you cannot quite remember.

The two image fields serve different purposes and it is worth knowing which is which. `image` points at the presentation version, framed and captioned with the code; `raw` points at the bare photograph with no overlay. If you are embedding into a page that already renders the code and title yourself, `raw` is the one you want, and it composites far better into an existing design.

Quick facts

Base URL: https://status.pizza
Authentication: No API key and no account.
Rate limit: No published limit. Responses are static and cacheable.
Pricing: Free.
CORS: Not enabled — call it from your server
Official docs: Read the docs

How to use the Status Pizza API

Every request below was executed against the live API on 2026-08-21, and the response shown is the real body it returned — not an illustration.

1. Look up HTTP 404 and its pizza

GET https://status.pizza/404.json

curl

curl 'https://status.pizza/404.json'

JavaScript (fetch)

const res = await fetch("https://status.pizza/404.json");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

Python (requests)

import requests

res = requests.get("https://status.pizza/404.json", timeout=20)
res.raise_for_status()
print(res.json())

Response — HTTP 200

{
  "code": "404",
  "title": "Not Found",
  "image": "https://status.pizza/404",
  "raw": "https://status.pizza/img/404.png",
  "category": "Client error"
}

Parameters

Parameter	Type	Required	Description
`(code)`	path	Required	The HTTP status code. Append `.json` for metadata, or omit it to get the image itself. `404.json`

Response fields

codestring: The status code as a string, not a number — mind the type if you are comparing it.
titlestring: Official reason phrase for the code, such as "Not Found".
categorystring: Class the code belongs to: `Informational`, `Success`, `Redirection`, `Client error` or `Server error`.
imagestring: URL of the presentation image, framed and captioned with the code.
rawstring: URL of the bare photograph with no overlay — the better choice for embedding into your own layout.

What you can build with the Status Pizza API

Illustrate error pages in a documentation site or style guide
Look up what a half-remembered status code actually means
Add a visual to a monitoring dashboard's failure states
Give a teaching example of the five status-code classes

Common errors and how to fix them

404 on the lookup itself

The code you asked for has no entry.

Fix: Only real, assigned status codes are covered. Invented codes such as 799 have no pizza.

Comparison against a number fails

`code` is serialised as a string.

Fix: Compare against `"404"`, or coerce with parseInt before comparing numerically.

Cross-origin fetch blocked

No Access-Control-Allow-Origin header is sent.

Fix: Fetch the JSON server-side. The image URLs themselves load fine in an `img` tag.

Status Pizza API — frequently asked questions

Is Status Pizza free to use?

Yes, with no key and no account. The images are the project's own photography.

How do I get JSON instead of an image?

Append `.json` to the status code, as in `/404.json`. Without the suffix the endpoint serves the picture itself.

What is the difference between image and raw?

`image` is the framed, captioned version intended to stand alone. `raw` is the unadorned photograph, which is what you want when your own page already displays the code and title.

Does it cover every status code?

It covers the assigned codes across all five classes. Unassigned or invented codes return a 404 rather than a placeholder.

Tools that pair with this API

HTTP Status Code Lookup

Search HTTP status codes from 100 to 599 with name, category and clear description. Filter by number or text — a fast, free, private in-browser reference.

URL Parser

Parse a URL into protocol, host, port, path, query parameters and hash. Handles relative URLs with a base and shows query params in a table. Free and private.

JSON Formatter

Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.

Status Pizza is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 2026-08-21; always check the official documentation before relying on this API in production, as terms and limits can change.