Ironfang Finance API problem type

`validation_timeout`

Validation timeout. HTTP 504.

What it means

The validation deadline passed before the validator answered. The outcome is indeterminate: it is not a verdict on the document, and no usage was charged.

What to do

Send the request again. If it repeats for the same document, the document may be unusually large or complex.

What the response carries

type: https://ironfang.uk/problems/validation_timeout, this page.
status: Always 504 for this code.
code: validation_timeout. 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: Always indeterminate, with usage_charged false: the API could not decide, which is not a verdict on the document, and nothing was charged.

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.