# Check usage, credits and billing

Source: https://docs.graphops.xyz/platform/cli/usage-and-billing

Find out what consumed your credits and how much remains, without leaving the terminal. These
commands only read. Change your plan, buy credits and manage payment in
**Billing**; see [Billing and credits](/platform/billing-and-credits).

## See your organization

`graphops orgs show` summarizes your organization: plan, available credits, active API keys and
service access. `graphops orgs products` lists its data services.

## Read usage

* `graphops usage daily --from 30d` shows credits consumed per day, today and the 29 days before;
`usage hourly` covers up to 90 days and `usage windows` lists the usage records billing settles.
Each row shows whether its period is `complete` or `in progress`. Times are UTC.
* Add `--by-attribution` to `usage daily` or `usage hourly` to see what consumed credits: each row
names its API key and its Managed Subgraph or Endpoint Alias, followed by the credits per API key
and per resource. `usage windows` always shows them. A credential that can't list API keys,
Managed Subgraphs or Endpoint Aliases sees their IDs instead.
* Filter by `--product` (`rpc`, `subgraphs` or `substreams`), `--api-key` with an API key's name or
its API key ID such as `gqk_0123456789abcdef01234567`, or resource.

### Choose a time range

`--from` and `--to` take a UTC timestamp such as `2026-11-01T00:00:00Z`, a UTC date such as
`2026-11-01`, `today` or `yesterday`. A date in `--to` includes that whole day.

* `--from month` starts at the first of this calendar month in UTC.
* `--from period` starts at the beginning of your current billing period, which follows your plan's
renewal date. It needs a plan.
* A duration counts whole days or hours, the current one included: `usage daily --from 7d` is today
and the 6 days before, and `usage hourly --from 24h` is this hour and the 23 before.

## Check credits and billing

* `graphops credits show` shows your balance. `graphops credits ledger` lists its entries: each
usage charge names its data service, API key, resource and usage window, and other entries say
whether they are a top-up, a plan invoice, expiring plan credits, a refund or an adjustment.
* `graphops billing show` shows your plan and subscription, its current billing period, whether
your invoices are paid, whether you can buy top-ups, automatic top-ups and service access.
`billing top-ups`, `billing notifications` and `billing catalog` list orders, notification
settings and prices.

## Next steps

* [Billing and credits](/platform/billing-and-credits): Change your plan and buy credits.
* [Usage and limits](/platform/usage-and-limits): Understand what each data service charges and its limits.
* [Scripts, CI and coding agents](/platform/cli/automation): Read usage as JSON in a script.