---
title: "Balance and settlement cutoff timestamp"
method: GET
path: "/balance"
tags: ["Billing"]
---

# Balance and settlement cutoff timestamp

`GET /balance`

## Request

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

## Response `200`

Balance.

- BalanceResponse
  - `balance_units` integer, required: Settled balance (amount_units), can be negative. On free plan, remaining free grant constitutes this balance (free accounts have no paid top-ups; balance derived from grants).
  - `balance_updated_at` string, date-time, required: RFC 3339 UTC, second precision, ending in `Z` (`2026-09-26T08:00:00Z`); no fractional seconds, without `+00:00` timezone offsets.
  - `settled_through` string, date-time, required: RFC 3339 UTC, second precision, ending in `Z` (`2026-09-26T08:00:00Z`); no fractional seconds, without `+00:00` timezone offsets.
  - `plan` 'free' | 'paid', required: Account plan: `free` (free tier, no paid top-ups) or `paid` (paid tier, after first paid top-up).
  - `free_monthly_units` integer, nullable, required: Free balance replenishment target (amount_units); null for paid tier. The historical field name does not imply a calendar month. At the end of a usage-started window (currently 30 days), eligible free accounts below the target are topped up to it; no accumulation or reduction of remaining credit.
  - `max_calls_per_sec` integer, nullable, required: Per-second call limit per account for free tier; null for paid tier. Token bucket capacity and refill rate equal this value, shared across all keys, chains, and Data API for the account. Each call in batch counted individually.
  - `free_window_ends_at` string, date-time, required: RFC 3339 UTC, second precision, ending in `Z` (`2026-09-26T08:00:00Z`); no fractional seconds, without `+00:00` timezone offsets.

## Other responses

- `401`: Missing or invalid session (without distinguishing cause).
- `429`: Rate limit exceeded.
- `500`: Internal server error.

---

[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)