Developer Documentation
Comprehensive HTTP status code and protocol reference for developers, DevOps engineers, and API designers. Covers status codes across multiple protocols (HTTP, SMTP, FTP, gRPC, SIP, WebSocket, DNS), error scenarios with debugging guides, decision trees, specifications, interactive tools, glossary, and in-depth guides. 15 languages supported.
- Status codes across 7+ protocols: HTTP, SMTP, FTP, gRPC, SIP, WebSocket, DNS
- Status categories (1xx Informational, 2xx Success, 3xx Redirect, 4xx Client Error, 5xx Server Error)
- Error scenarios with root cause analysis and resolution steps
- Decision trees — interactive flowcharts for choosing the right status code
- Protocol specifications (RFCs) with status code references
- Side-by-side status code comparisons
- Mock server for testing status code responses
- Interactive tools: header checker, status tester, redirect tracer, JWT decoder, CORS checker
- Protocol glossary with technical definitions
- In-depth guides on HTTP, REST, API design
Quick Start
curl -s "https://statuscodefyi.com/api/v1/rest/status-codes/"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/rest/protocols/ | List protocols |
| GET | /api/v1/rest/status-categories/ | Status categories |
| GET | /api/v1/rest/status-codes/ | All status codes |
| GET | /api/v1/rest/status-codes/{slug}/ | Status code detail |
| GET | /api/v1/rest/glossary-categories/ | Glossary categories |
| GET | /api/v1/rest/glossary-terms/ | Glossary terms |
| GET | /api/v1/rest/content-series/ | Guide series |
| GET | /api/v1/rest/articles/ | Guide articles |
| GET | /api/v1/rest/decision-trees/ | Decision trees |
| GET | /api/v1/rest/scenarios/ | Error scenarios |
| GET | /api/v1/rest/specifications/ | Protocol specifications |
| GET | /api/v1/rest/faqs/ | FAQs |
| GET | /api/v1/rest/stats/ | Site statistics |
| GET | /api/v1/rest/search/?q={query} | Search across all content |
URL Patterns
Use these patterns to construct URLs programmatically:
/all/
All status codes across protocols (e.g. /all/)
/{protocol}/
Protocol index (e.g. /http/)
/{protocol}/{status}/
Status code detail (e.g. /http/200-ok/)
/scenarios/
Error scenarios (e.g. /scenarios/)
/scenarios/{slug}/
Scenario detail (e.g. /scenarios/cors-preflight-failure/)
/decide/
Decision trees (e.g. /decide/)
/decide/{slug}/
Decision tree detail (e.g. /decide/redirect-status/)
/specs/
Protocol specifications (e.g. /specs/)
/specs/{slug}/
Specification detail (e.g. /specs/rfc-7231/)
/compare/
Status code comparisons (e.g. /compare/)
/compare/{slug}/
Comparison detail (e.g. /compare/301-vs-302/)
/glossary/
Protocol glossary (e.g. /glossary/)
/glossary/{slug}/
Glossary term detail (e.g. /glossary/idempotent/)
/guides/
In-depth guides (e.g. /guides/)
/guides/{slug}/
Guide detail (e.g. /guides/rest-api-status-codes/)
/tools/
Interactive tools (e.g. /tools/)
/tools/header-checker/
HTTP header checker (e.g. /tools/header-checker/)
/tools/status-tester/
Status code tester (e.g. /tools/status-tester/)
/tools/mock-server/
Mock server (e.g. /tools/mock-server/)
/tools/redirect-tracer/
Redirect tracer (e.g. /tools/redirect-tracer/)
/tools/jwt-decoder/
JWT decoder (e.g. /tools/jwt-decoder/)
/tools/cors-checker/
CORS checker (e.g. /tools/cors-checker/)
/search/
Search status codes, glossary (e.g. /search/?q=404)
Response Format
All endpoints return JSON with pagination:
Example JSON response
{
"count": 636,
"next": "https://example.com/api/v1/items/?page=2",
"previous": null,
"results": [
{"slug": "example", "name": "Example Item", "...": "..."}
]
}
OpenAPI Specification
Full API schema available as OpenAPI 3.1.0 JSON. Import into Swagger UI, Postman, or any OpenAPI-compatible tool.
SDK Packages
PyPI
pip install protocolcodes
HTTP status codes and protocol reference API client
Embed Widget
Embed data cards on your site:
https://widget.statuscodefyi.com
npm install statuscodefyi-embed
Format Support
- Markdown endpoints: Append
.mdto any page URL for LLM-friendly markdown output. - Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id.