Skip to content
Last updated

Error Reference

All our APIs return errors following RFC 9457 (Problem Details for HTTP APIs).

Error Response Structure

typestring(uri)required

A URI reference that identifies the problem type. This MUST link to public documentation. e.g., "https://developer-next.ingrid.com/errors/validation-error"

titlestringrequired

A short, human-readable summary of the problem type (translated). e.g., "Validation Failed"

statusinteger(int32)required

The HTTP status code. e.g., 400

detailstring

A human-readable explanation specific to this occurrence (translated). e.g., "One or more fields failed validation."

trace_idstring

A unique request ID for tracing this request across all microservices.

errorsArray of objects(Errors.DetailedError)

An array of detailed validation errors. This is omitted if not applicable.