---
title: creative_usage_get
description: Retrieve the latest Creative generation charges in the connected workspace.
canonical_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_usage_get
markdown_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_usage_get.md
contentType: reference
---

# creative_usage_get

Retrieve the latest Creative generation charges in the connected workspace.

**Operation:** Read-only. The OAuth grant determines the workspace. This tool requires the Creative flag in that workspace.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query.limit` | integer | No | Maximum records to return. Use 1 to 100. Default is 20. |
| `query.job_id` | string | No | Return usage for this job ID. |

Use `data.usage` to review records in newest-first order. Each record reports the reserved, captured, or refunded amount according to its status.

## Sample prompt

```text
Show recent Creative usage and identify which charges are still reserved.
```

[Creative](https://orchestor.io/docs/en/mcp/tools/creative.md) · [Tools](https://orchestor.io/docs/en/mcp/tools.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)
