Visual RFC.
ALL RFCs / RFC 9457
Read the RFC ↗
RFC 9457 / MECHANISM GUIDE

A problem response

01

A JSON problem object provides machine-readable error information alongside an HTTP status.

Related RFCs and changes

“Updates” changes part of an earlier RFC. “Obsoletes” replaces it. This list shows selected related documents.

DIAGRAM§ 3 ↗
RFC 9457 · § 3EXAMPLE
3 / 3
A problem responseA JSON problem object provides machine-readable error information alongside an HTTP status.A problem responseHTTP/1.1 403 ForbiddenContent-Type: application/problem+json{ "type": "https://api.example/credit", "title": "Insufficient credit", "status": 403 }HTTP status and generated status member agree
03
Interpret both layers

Generic HTTP software reads the status; clients may use the structured details.

Protocol participantThreat or exceptionProtocol controlSimplified drawings · precise section references
WHAT CHANGED
RFC 7807RFC 9457 Appendix D

The revision adds a registry of common problem type URIs and clarifies multiple-problem handling and type-URI guidance.

Read the updated RFC section ↗
KEY POINT

Use application/problem+json for the JSON format.

  • Use application/problem+json for the JSON format.
  • Problem details complement HTTP status semantics rather than redefining them.
  • The status member, if present, must match the status generated in the HTTP response.
DETAILS

Examples are illustrative. Consult the linked RFC and its errata for implementation details.

Read the RFC section ↗

Diagrams simplify the RFC. Read the linked sections for complete requirements.

Privacy
All chapters in this RFC
  1. A problem response
  2. Problem type identity
  3. Human-readable details
  4. Extension members
  5. Types and safe disclosure
RFC 9700 / CHAPTERS

Chapters

For full details, tables, algorithms, and exceptions, read the original RFC.

RFC status and corrections ↗