> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gc.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage

> `gcai usage` commands.

## `gcai usage credits`

Get credit usage

```bash theme={null}
gcai usage credits --start-date <value> --end-date <value> [--timezone <value>]
```

| Flag                   | Type     | Required | Description                                                                |
| ---------------------- | -------- | -------- | -------------------------------------------------------------------------- |
| `--start-date <value>` | `string` | yes      | Inclusive range start (`YYYY-MM-DD`).                                      |
| `--end-date <value>`   | `string` | yes      | Inclusive range end (`YYYY-MM-DD`).                                        |
| `--timezone <value>`   | `string` |          | IANA timezone for day boundaries (default `UTC`), e.g. `America/New_York`. |

Wraps `GET /credit-usage` — see [Get credit usage](/api-reference/get-credit-usage) for full parameter semantics.

## `gcai usage get`

Get usage summary

```bash theme={null}
gcai usage get --start-date <value> --end-date <value> [--timezone <value>]
```

| Flag                   | Type     | Required | Description                                                       |
| ---------------------- | -------- | -------- | ----------------------------------------------------------------- |
| `--start-date <value>` | `string` | yes      | Inclusive range start (`YYYY-MM-DD`).                             |
| `--end-date <value>`   | `string` | yes      | Inclusive range end (`YYYY-MM-DD`).                               |
| `--timezone <value>`   | `string` |          | IANA timezone for the api channel day boundaries (default `UTC`). |

Wraps `GET /usage` — see [Get usage summary](/api-reference/get-usage) for full parameter semantics.