API

spend_limit_exceeded

HTTP 403. Spend limit exceeded

What it means

The token's lifetime spend limit would be exceeded.

What to do

limit_cents is the token's cap and spent_cents what it has already committed. The cap is on the token, not the order: create a token with a higher limit in the web app, or ask a person to approve the purchase. Retrying with the same key does not change the answer. See agent spend limits.

Retrying

Do not retry the same request. Change it first.

Extra members

limit_cents: The token's spend limit in cents.
spent_cents: Cents the token has already committed.

Example

json

{
  "type": "https://reuseforge.com/docs/api/errors/spend_limit_exceeded",
  "title": "Spend limit exceeded",
  "status": 403,
  "detail": "This token may commit at most 5000 cents in total and has spent 4200; 1500 more would exceed it. Create a token with a higher limit from the web app.",
  "instance": "/api/v1/items/acme/invoice-extractor",
  "code": "spend_limit_exceeded",
  "request_id": "req_c4v8n2m6x1z3",
  "limit_cents": 5000,
  "spent_cents": 4200
}

Every error is application/problem+json (RFC 9457). Branch on code, show detail to people and quote request_id when you ask for help. See the error catalogue.