Skip to content

Check usage, credits and billing

Read your organization's credit consumption, balance, ledger and plan from the GraphOps CLI, by day, hour, API key or resource.

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.

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

Last updated