Documentation

Why Am I Getting a "Not Enough Credits" Error?

Why the 403 Not Enough Credits error occurs and how to fix it by adjusting page_size.

A 403 Not Enough Credits error means the request you're sending is trying to use more credits than you currently have in your account.

The most common cause: page_size

If you don't explicitly set a page_size, the API defaults to 100 results per request. Depending on the endpoint, each result may cost multiple credits.

For example:

  • Endpoint costs 3 credits per result
  • Default page_size is 100
  • Request attempts to use 300 credits (3 × 100)

If your balance is under 300 credits, this triggers the error.

How to fix it

Lower your page_size to fit within your available credit balance:

{
  "page_size": 40
}
json

For example, with 120 credits on a 3-credits-per-result endpoint, set page_size to 40 or lower.

Quick reference

IssueLikely causeFix
403 Not Enough CreditsRequest exceeds current credit balanceLower your page_size

If you're unsure whether the issue is related to your plan, API key access, or something else, reach out to [email protected] or use the in-app messenger.