Skip to content

Ironfang Finance API problem type

malformed_request

Malformed request. HTTP 400.

What it means

The request itself is wrong, not the document being processed: a parameter, header or body field is missing or invalid. errors names each field.

What to do

Correct the fields listed in errors and send the request again. The same request will fail the same way.

What the response carries

type
https://ironfang.uk/problems/malformed_request, this page.
status
Always 400 for this code.
code
malformed_request. Stable: branch on this, not on the wording of title or detail.
detail
What happened this time, safe to show to a person. It never carries invoice content.
request_id
The same value as the X-Ironfang-Request-ID header. Quote it to support.
retry_after_seconds
Never present for this code.
outcome
Absent. This code is not a statement about any document.

Problems follow RFC 9457 and are served as application/problem+json. A validation finding is never a Problem: an invalid invoice is a successful response that lists its findings. See every problem type, the Finance guide and the OpenAPI contract.