---
title: "get usage · RUAL Documentation"
description: "Report total tokens and cost used on this connection (USD and the connection's currency), with a per-category breakdown."
canonical: https://docs.rual.nl/block-types/anthropic/anthropicconnection_get_usage
language: en
---

# get usage

This block is part of the [`anthropic`](https://docs.rual.nl/block-types/anthropic) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

Report total tokens and cost used on this connection (USD and the connection's currency), with a per-category breakdown.

- flow `flow`

- connection required `anthropicconnection`

- flow `flow`

- success `condition`

- connection `anthropicconnection` The same connection, passed through so it chains on to the next block.

- total cost `number` Total cost in the connection's currency.

- total cost (USD) `number`

- currency `value`

- tokens `object` input_tokens, output_tokens, cache_read_tokens, cache_creation_tokens.

- by category `array ` Per-category token breakdown.

- calls `number` Total number of calls.

| `usage` |
| --- |
| `spending` |
| `claude usage` |
| `ai cost` |
| `token usage` |

A typical wiring for [get usage](https://docs.rual.nl/block-types/anthropic/anthropicconnection_get_usage): a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) starts the flow; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%20ui/state_debug).

![Studio canvas example for the get usage block: typical wiring for get usage.](https://docs.rual.nl/canvas-examples/anthropicconnection_get_usage.png)

### Version history

Introduced in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).