Skip to main content

QUOTA_EXHAUSTED

The plan’s included Relay Units are used up.

HTTP status429
GroupRelay path
RetryableNo — sending it again changes nothing
Re-signNONE — 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.