Developers

APIs, feeds, and machine-readable endpoints for integrating ProtocolCodes data into your applications.

Public REST API v1

Free JSON API — no authentication required. All endpoints return JSON with CORS support.

Method Endpoint Description
GET /api/v1/code/{slug}/ Full status code detail with protocol info and related codes
GET /api/v1/protocol/{slug}/ Protocol info with all status codes
GET /api/v1/term/{slug}/ Glossary term definition and related terms
GET /api/v1/search/?q={query} Search across codes, protocols, and terms (min 2 chars)
GET /api/v1/compare/?slug1=&slug2= Side-by-side status code comparison
GET /api/v1/random/ Random status code for discovery
GET /api/v1/spec/{slug}/ RFC/specification detail with related codes
GET /api/v1/scenario/{slug}/ Debugging scenario with diagnosis and resolution
GET /api/v1/openapi.json OpenAPI 3.1.0 specification
# Example
curl -s "https://statuscodefyi.com/api/v1/code/404-not-found/" | python3 -m json.tool

Markdown Access .md

Append .md to any page URL to get a plain-text markdown version optimized for LLMs and automated tools.

# Examples
https://statuscodefyi.com/glossary.md
https://statuscodefyi.com/guides.md
https://statuscodefyi.com/guides/http-caching-guide.md
https://statuscodefyi.com/http/200-ok.md
https://statuscodefyi.com/glossary/idempotency.md

API Endpoints

Endpoint Description Format
/search/?q= Universal search across all content JSON / HTML
/llms.txt AI-readable site summary Markdown
/llms-full.txt Complete content index Markdown
/feed/rss/ Guides RSS feed XML (RSS 2.0)
/feed/atom/ Guides Atom feed XML (Atom 1.0)
/sitemap.xml XML sitemap index XML
/robots.txt Crawler access rules Text
/.well-known/security.txt Security contact (RFC 9116) Text
*.md Markdown version of any page Markdown

Data Sources

Status codes are sourced from official RFCs and protocol specifications. All content is maintained by the ProtocolCodes team.