---
title: "List recent billing periods"
method: GET
path: "/v1/usage/periods"
tags: ["public", "usage"]
---

# List recent billing periods

`GET /v1/usage/periods`

## Request

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

What each recent settled cycle actually cost. Unlike the current-period estimate on GET /v1/usage, estimated_cost_minor here is the SETTLED amount taken for the cycle, not a projection. The three most recent settled cycles; a cycle appears once its invoice is paid. Carries no Stripe invoice id — that names a record in a system the caller cannot reach.

## Response `200`

OK

- MeteringPublicPeriods
  - `periods` MeteringPublicPeriodSummary[]
    - `currency` string
    - `estimated_cost_minor` integer
    - `period_end` string
    - `period_start` string

## Other responses

- `401`: invalid or missing API key
- `403`: the key lacks usage:read
- `500`: Internal Server Error

---

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