---
title: "Calls and CU usage grouped by UTC date, API key, chain, and method"
method: GET
path: "/usage"
tags: ["Billing"]
---

# Calls and CU usage grouped by UTC date, API key, chain, and method

`GET /usage`

## Request

- Base URL: `https://console-api.blockvectra.com/v1`
- URL: `https://console-api.blockvectra.com/v1/usage`
- Auth: HTTP bearer

Closed UTC date range of at most 31 days; to cannot be later than today. key_id must belong to this account, including revoked keys. Rows are grouped by date, key_id, chain, and method. Includes unsettled usage. Limited to 10 requests per minute per user. Push methods are push.token_transfer, push.native_transfer, push.log, and push.address_day: calls counts billed events or address-days, cu is their metered cost, and chain is null. Push usage belongs to its charge date; delivery retries do not add usage.

## Query parameters

- `from` string, date, required
- `to` string, date, required
- `key_id` string

## Response `200`

Summary rows in ascending order of `(date, key_id, chain, method)`, with nulls first; groups without usage are omitted.

- UsageResponse
  - `from` string, date, required
  - `to` string, date, required
  - `rows` UsageRow[], required
    - `date` string, date, required
    - `key_id` string, required
    - `chain` string, nullable, required: Chain slug; null for chain-agnostic calls (e.g. Data API data.chains) and push charges.
    - `method` string, required: Metered method name, including JSON-RPC, Data API, WebSocket, and push methods.
    - `calls` integer, required: Call count; for push, billed event count or address-day count.
    - `cu` integer, required

## Other responses

- `400`: Invalid date format, `from > to`, range exceeding 31 days, or `to` later than today.
- `401`: Missing or invalid session (without distinguishing cause).
- `404`: `key_id` does not belong to this account.
- `429`: Rate limit exceeded.
- `500`: Internal server error.
- `503`: Usage service error or timeout (10 s), affecting this endpoint only.

---

[API](https://skmtc.dev/blockvectra/apis/blockvectra-console-api.md) · [All operations](https://skmtc.dev/blockvectra/apis/blockvectra-console-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blockvectra/apis/blockvectra-console-api/revisions/28c91298f433?raw)