Skip to content

Ironfang Finance API problem type

free_allowance_exhausted

Free allowance used up. HTTP 429.

What it means

This month's free allowance for the operation's meter is used up and paid usage is not enabled on the billing account. Nothing was accepted or charged. Validations and generations have separate allowances.

What to do

Enable paid usage in Billing, or wait for the free allowance to renew at reset_at, the start of the next UTC month.

What the response carries

type
https://ironfang.com/problems/free_allowance_exhausted, this page.
status
Always 429 for this code.
code
free_allowance_exhausted. 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.