# Insufficient Credits

<!-- GENERATED by gateway/scripts/generate-error-docs.mjs — DO NOT EDIT. This page renders gateway/contracts/errors.json; edit the catalogue and regenerate. -->

| | |
| --- | --- |
| HTTP status | `402` |
| Type | `https://docs.investorliftdata.com/errors/insufficient-credits` |
| Retryable | No |
| Retry-After header | No |

## What the body says

The response body says:

> This Account does not have enough Credits for this Metered Call. No Credits were consumed. Add Credits to the Account and send the request again.

## What happened to the Credits

No Credits are consumed by a call that ends here.

## Retrying

**Not retryable.** Sending the same request again returns the same error. Change the request as the detail directs before sending it again.

## Body members

Beyond the base members (`type`, `title`, `detail`, `status`, `trace_id`), the body
carries:

| Member | Meaning |
| --- | --- |
| `balance` | The Account's Balance at the moment of refusal, as the Ledger reported it. |
| `required` | The number of Credits this Metered Call required. |
| `top_up_url` | The Portal page where Credits can be added to the Account. |

## Retry-After

No. This response carries no `Retry-After` header.

Every error response is an RFC 9457 Problem Detail sent as `application/problem+json`,
and every response carries a `trace-id` header, repeated in the body as `trace_id`.
The Trace ID is the only handle support needs to find your call.