LIFT DATA
  • Getting started
  • The contract
  • Errors
  • API reference

Insufficient Credits

HTTP status402
Typehttps://docs.investorliftdata.com/errors/insufficient-credits
RetryableNo
Retry-After headerNo

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:

MemberMeaning
balanceThe Account's Balance at the moment of refusal, as the Ledger reported it.
requiredThe number of Credits this Metered Call required.
top_up_urlThe 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.

Last modified on August 11, 2026
On this page
  • What the body says
  • What happened to the Credits
  • Retrying
  • Body members
  • Retry-After