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

# roark usage get

> Get usage & cost

Report billable usage and cost for the organization over a time window, broken down by project (highest spend first). Pass `from`/`to` as ISO 8601 timestamps; optionally pass `projectId` to scope the report to one project. Amounts are billable spend only (what we absorb is never included). Authenticated by either an organization API key with the `usage:read` permission (any project in the organization), or a project API key with the `billing:read` permission (that key's own project only; any other `projectId` is a 403).

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark usage get [options]
```

> [!NOTE]
>
> Calls `GET /v1/usage`

## Options

**--from** `string` *required*

Start of the window (inclusive), ISO 8601.

**--to** `string` *required*

End of the window (exclusive), ISO 8601. Must be after `from`, and the window may not exceed 366 days.

**--project-id** `string`

Limit the report to a single project. Omit for the whole organization.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark usage get --from <value> --to <value>
```

Every command also takes the [global options](/cli-reference/overview.md#global-options) and sets one
of the [exit codes](/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.