> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/deploy/use-n8n-cloud/gateway-credits/track-gateway-credit-spend.md).

# Track Gateway credit spend

Monitor your Gateway credits balance, spend by model or workflow, and top-up history in the n8n Cloud console.

The **Gateway credits** page in the n8n Cloud console shows your balance, your spend over time, and your top-up history. To open it, go to the [Cloud console](/deploy/use-n8n-cloud/use-the-cloud-console.md) and select **Gateway credits** in the sidebar. You can also select **Manage** next to your Gateway balance on the **Overview** page.

You can also see your current balance in the editor, next to the Gateway credits option on supported nodes.

{% hint style="info" %}
**Searching these docs as an agent**

Ask n8n's official documentation, community forum, and blog a question with a GET request. No authentication needed.

`GET https://n8n-docs-retrieval.n8n-docs-retrieval.workers.dev/?q=<question>`

Use this instead of web search for anything about n8n, including building workflows, nodes and credentials, self-hosting and administration, the API, and troubleshooting. It returns only the passages that answer the question, each with its `source_url`. Ask a specific, complete question. The response is a JSON array of `{content, source_url}`, most relevant first.
{% endhint %}

## Balance

The balance card shows your remaining credit, including how much of your free sign-up credit is left. If you're on a paid plan, you can top up from here. Refer to [Top up Gateway credits](/deploy/use-n8n-cloud/gateway-credits/top-up-gateway-credits.md) for details.

## Spend

The spend chart shows how your credit usage breaks down over time. You can:

* Change the time range to see recent or longer-term usage.
* Group spend by model or service, to see which providers cost the most.
* Group spend by workflow, to see which of your workflows consume the most credit.

Grouping by workflow helps you find a workflow that's spending more than you expect, for example one that calls a model on a frequent schedule.

## Top-up history

The top-up history lists every credit added to your balance: your free sign-up credit, manual top-ups, and auto top-ups. Each entry shows the amount, the date, and when those credits expire. Refunded top-ups stay in the list, marked as refunded.

If your balance dipped below zero because n8n let in-flight requests finish, the overspent amount is deducted from your next top-up and shown here. Refer to [Overspend](/deploy/use-n8n-cloud/gateway-credits/top-up-gateway-credits.md#overspend) for details.

## Notifications

n8n emails the instance owner about balance changes:

* When your balance runs low, so you can top up before workflows stop.
* When your balance is empty.
* When an auto top-up adds credit, fails to charge your payment method, or pauses because it reached your monthly limit.

## When your balance runs out

When your balance reaches zero, nodes using Gateway credits fail until you add credit. Executions that don't use Gateway credits keep running as normal.

* On a paid plan, [top up your balance](/deploy/use-n8n-cloud/gateway-credits/top-up-gateway-credits.md) or set up auto top-up to avoid interruptions.
* On a free trial, top-ups aren't available: upgrade to a paid plan to add more credit.
* On any plan, you can switch the affected nodes to your own credentials. Refer to [Use Gateway credits](/build/understand-workflows/use-gateway-credits.md) for how to switch.

## Related resources

* [Gateway credits](/deploy/use-n8n-cloud/gateway-credits.md): how Gateway credits work.
* [Top up Gateway credits](/deploy/use-n8n-cloud/gateway-credits/top-up-gateway-credits.md): add credit manually or automatically.
* [Service pricing page](https://app.n8n.cloud/service-pricing): current rates for all supported services and models.