Skip to content

List error codes

View as Markdown
get /api/error-codes

Retrieves the collection of ErrorCode resources.

Returns the whole error-code catalog, each message localized by the Flowkiwi-Locale header. Narrow the result with the optional domain, httpStatus and slug query filters.

Query parameters

NameTypeRequiredDescription
properties[]string[]-Allows you to reduce the response to contain only the properties you need. If your desired property is nested, you can address it using nested arrays. Example: properties[]={propertyName}&properties[]={anotherPropertyName}&properties[{nestedPropertyParent}][]={nestedProperty}
domainstring-Filter by error domain (e.g. "validation", "product").
httpStatusinteger-Filter by HTTP status code (e.g. 404, 422).
slugstring-Filter by exact error slug (e.g. "product.not_found").

Response

200 - ErrorCode collection

PropertyTypeRequiredDescription
searchobject-
Show search fields
PropertyTypeRequiredDescription
@typestring-
mappingobject[]-
Show mapping fields
PropertyTypeRequiredDescription
@typestring-
propertystring | null-
requiredboolean-
variablestring-
templatestring-
variableRepresentationstring-
totalItemsinteger-
memberErrorCode[]required
Show member fields
PropertyTypeRequiredDescription
@contextstring | object-
@idstringrequired
@typestringrequired
codestring-Immutable UUID of the error.
descriptionstring-Technical English message (developer-facing, stable).
domainstring-
httpStatusinteger-
messagestring-User-friendly message in the request locale.
slugstring-

Errors

403 - Forbidden

PropertyTypeRequiredDescription
@contextstring | object-
@idstringrequired
@typestringrequired
codestring-Stable identifier of the error in the error code catalogue (see /api/error-codes). Present on catalogued errors only.
descriptionstring | null-
detailstring | null-A human-readable explanation specific to this occurrence of the problem.
instancestring | null-A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
messagestring-End-user message localized in the request locale, with this occurrence's values substituted. Present on catalogued errors only.
slugstring-Stable, readable key of the error in the error code catalogue. Present on catalogued errors only.
statusinteger | null-
titlestring | null-A short, human-readable summary of the problem. For a catalogued error it repeats the slug.
typestring-A URI reference that identifies the problem type. For a catalogued error it is the error code resource, /api/error-codes/{code}.