Error · 402

payment_required

Payment required

What happened

An unpaid invoice blocks this operation.

What to do

List unpaid invoices, then hand the account owner a payment link.

The response body carries a recovery object with the same guidance in machine-readable form: recovery.action names the call to make next, and recovery.hint is one sentence a model can act on. Not every code carries one — a 401, for instance, has nothing to recover to but a valid token.

Back to the full error reference

402 application/problem+json

{9 keys}

:"https://api.inleed.com/errors/payment_required",

:"Payment required",

:402,

:"An unpaid invoice blocks this operation.",

:"payment_required",

:"/api/v1/…",

:"req_01hxa3b4c5d6e7f8g9h0j1k2m3",

:"2026-08-29T12:34:56.000Z",

:{2 keys}

:"…",

:"List unpaid invoices, then hand the account owner a payment link."

}

Click a key to copy its jq path.

Handling it

// Branch on code, never on title or detail — those are written for
// humans and may change wording at any time.

if (problem.code === 'payment_required') {
  // List unpaid invoices, then hand the account owner a payment link.
}