---
title: "Get current-period usage"
method: GET
path: "/v1/usage"
tags: ["public", "usage"]
---

# Get current-period usage

`GET /v1/usage`

## Request

- Base URL: `https://api.vozora.io`
- URL: `https://api.vozora.io/v1/usage`
- Auth: API key in header `Authorization`

What the account has consumed this billing period and what it is estimated to cost. The cost is an ESTIMATE: Stripe rounds each tier up at invoice time, so the settled amount can differ by up to a minute per tier. period_start and period_end are the account's Stripe billing cycle where one resolves, and the calendar month otherwise. GET /v1/usage/instances/{id} reports the same WINDOW, so the two are comparable — but per-instance costs do NOT sum to this total. Each tier is billed on minutes rounded up, and the rounding happens once over the account's aggregate here and once per instance there, so summing the instances overstates the account by up to a minute of each tier's rate per instance. This figure is the account total; use it, not a sum.

## Response `200`

OK

- MeteringPublicUsageSummary
  - `cap_consumed_pct` number
  - `cap_minor` integer
  - `currency` string
  - `estimated_cost_minor` integer
  - `fired_thresholds` integer[]
  - `period_end` string
  - `period_start` string
  - `pm_grace_until` string
  - `tiers` MeteringPublicTierUsage[]
    - `component` string
    - `estimated_cost_minor` integer
    - `minutes` integer
    - `product_id` string
    - `rate_minor_per_minute` integer
    - `seconds` integer
    - `unit` string: Unit is what "minutes" counts: "minute" for compute, "gb_minute" for a disk line (BAN-1615). Two lines' minutes are only comparable when their units match.
  - `total_seconds` integer

## Other responses

- `401`: invalid or missing API key
- `403`: the key lacks usage:read
- `500`: Internal Server Error
- `503`: usage_rate_unknown: a tier in use has no rate for the period

---

[API](https://skmtc.dev/vozora/apis/vozora-api.md) · [All operations](https://skmtc.dev/vozora/apis/vozora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vozora/apis/vozora-api/revisions/56f15734fc5a?raw)