---
title: "List Periods"
method: GET
path: "/organization/usage/periods"
tags: ["usage"]
---

# List Periods

`GET /organization/usage/periods`

The caller's own organization's selectable usage windows, newest first.

A bare array, not an envelope: that is the shape the client types and the mock
server already serves. ``end`` is exclusive and is what the client sends back
as ``date`` on the other usage reads.

## Response `200`

Successful Response

- UsagePeriod[]
  - `start` string, date-time, required
  - `end` string, date-time, required — Exclusive upper bound; sent back as the `date` query param.

## Changes

> 57 revisions in range; 9 not diffed.

- **2026-09-11** `c5e1ea955e81` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/traversal/apis/fastapi/changes/organization/usage/periods/get.md)

---

[API](https://skmtc.dev/traversal/apis/fastapi.md) · [All operations](https://skmtc.dev/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/traversal/apis/fastapi/revisions/c3bd9dec6c16?raw)