validator_unavailable

What it means

The validator crashed or was unavailable, or a dependency it needs failed. The outcome is indeterminate: it is not a verdict on the document, and no usage was charged.

What to do

Retry after retry_after_seconds. If it persists, contact support with the request_id.

What the response carries

type

https://ironfang.uk/problems/validator_unavailable, this page.

status

Always 503 for this code.

code

validator_unavailable. 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

May be present, with a matching Retry-After header: wait that long before retrying.

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.