QUOTA_EXHAUSTED
The plan’s included Relay Units are used up.
| HTTP status | 429 |
| Group | Relay path |
| Retryable | No — sending it again changes nothing |
| Re-sign | NONE — do not ask the user to sign anything |
What happened
details.reason is CAP_REACHED_PAYG_OFF (the cap is reached and pay-as-you-go is off) or PAYG_ESCROW_EMPTY (pay-as-you-go is on but its escrow is empty).
What to do
Turn on pay-as-you-go, top up its escrow, upgrade the tier, or wait for the next period. There is no Retry-After: time alone does not fix this.
Extra members
This code carries reason in the problem document, on top of the common members.
The problem document
Every error is application/problem+json (RFC 9457) with the same shape:
{
"type": "https://docs.co-relayer.com/errors/quota-exhausted",
"title": "The plan’s included Relay Units are used up.",
"status": 429,
"detail": "A sentence about this specific occurrence.",
"instance": "req_01JB…",
"code": "QUOTA_EXHAUSTED",
"retryable": false,
"resign": "NONE",
"hint": "Turn on pay-as-you-go, top up its escrow, upgrade the tier, or wait for the next period. There is no `Retry-After`: time alone does not fix this."
}
See the error model for what each member means and how to handle unknown codes.