BYTETOOLS

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 21 Aug 2026

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 21 Aug 2026, 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

ParameterTypeRequiredDescription
(code)pathRequiredThe 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

Alternatives to Status Pizza API

If Status Pizza does not fit, these food & drink apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.

APIWhat it doesAuthCORSLast verified
TheMealDBFree recipe API with no signup: search meals by name, ingredient, category or area, with full instructions, ingredient lists and photos. Tested example.No keyYes19 Aug 2026
TheCocktailDBFree cocktail recipe API with no signup: search drinks by name, ingredient or category, with instructions, measures, glass type and photos. Tested example.No keyYes19 Aug 2026
Open Food FactsFree food product API with no key: look up nutrition, ingredients, allergens, Nutri-Score and eco-score by barcode. 3M+ products. Tested curl example.No keyYes19 Aug 2026
FruityviceFree fruit API with no key: nutritional data, family, genus and order for dozens of fruits. Simple flat JSON, ideal for beginners. Tested curl example.No keyNo19 Aug 2026
WhiskyHunterFree WhiskyHunter API with no key: distillery information and whisky auction price statistics from international auction houses. Niche but tested and open.No keyNo20 Aug 2026
BaconMockupFree placeholder photo service with no key: put width and height in the path and get a real bacon photograph back at exactly that size. Tested example included.No keyNo21 Aug 2026
All Food & Drink APIs

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