API PROBLEM DETAILS / RFC 9457
API error reference
API error definitions, HTTP statuses, and response examples based on RFC 9457.
Construct a response manuallyProblem catalogue
15 definitions15 definitions
Malformed request
The server cannot process the request because its syntax or framing is invalid.
malformed-requestValidation failure
The content type and syntax are understood, but the request content cannot be processed because it fails validation.
validation-errorAuthentication required
The request lacks valid authentication credentials for the target resource.
authentication-requiredForbidden
The server understands the request but refuses to fulfill it.
forbiddenResource not found
The server did not find a current representation of the target resource, or is unwilling to disclose that it exists.
not-foundMethod not allowed
The request method is known by the server but is not supported by this resource.
method-not-allowedConflict
The request conflicts with the current state of the target resource.
conflictUnsupported media type
The request content format is not supported for this method on the target resource.
unsupported-media-typePayload too large
The request content is larger than the server is willing or able to process.
payload-too-largeRate limit exceeded
The caller has sent too many requests in a given amount of time.
rate-limitInternal error
The server encountered an unexpected condition that prevented it from fulfilling the request.
internal-errorBad gateway
A server acting as a gateway or proxy received an invalid response from an upstream server.
bad-gatewayService unavailable
The server is temporarily unable to handle the request because of overload or scheduled maintenance.
service-unavailableGateway timeout
A server acting as a gateway or proxy did not receive a timely response from an upstream server needed to complete the request.
gateway-timeoutApproval window closed
The requested approval conflicts with the submission’s current state because its approval window has closed.
approval-window-closedNo definitions match your search.
These names and type URIs are template conventions, not an RFC-mandated catalogue. Your application chooses when each contract applies.