quota_exceeded

HTTP 429   title: Quota exceeded

What it means

A rate or volume quota the operator enforces has been exhausted — for example, a cap on how many KYC verifications one principal may have open at the same time. The Kiosk engine never raises this code itself; an operator emits it from its own handler when it meters something. It is the one refusal in the vocabulary that means come back later rather than no: finish or abandon whatever is already outstanding, then retry.

What to do next

Back off and retry later. The core wire prices abuse with proof-of-work (pow_required) rather than with quotas, so a 429 means the operator has added a quota layer of its own.

On the wire

{
  "type":   "https://kiosk.tech/problems/quota_exceeded",
  "title":  "Quota exceeded",
  "status": 429,
  "detail": "… what went wrong on THIS request …",
  "code":   "quota_exceeded"
}

This page documents the RFC 9457 type URI https://kiosk.tech/problems/quota_exceeded. The URI is an identifier, not a locator a client should fetch: branch on the document’s code member. The normative definition lives in the error vocabulary of the Kiosk specification (§9 of the formal spec).