---
title: "List Usage For Month"
method: GET
path: "/api/v1/billing/usage/month"
tags: ["Billing"]
---

# List Usage For Month

`GET /api/v1/billing/usage/month`

## Request

- The document declares no server URL.
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.mor.org/oauth2/authorize`
    - Token URL: `https://auth.mor.org/oauth2/token` scopes: `aws.cognito.signin.user.admin`, `openid`, `email`, `profile`
  - HTTP bearer

Get paginated list of usage entries for a specific month.

Authenticate with either a Cognito JWT or an ``sk-…`` API key.

Parameters:
- year: Year
- month: Month (1-12)
- limit: Maximum number of items to return (1-∞)
- offset: Number of items to skip

Returns newest entries first.

## Query parameters

- `year` integer, required: Year
- `month` integer, required: Month (1-12)
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- UsageListResponse: Paginated response for usage entries.
  - `items` UsageEntryResponse[], required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `model_name` string
    - `model_id` string
    - `endpoint` string
    - `tokens_input` integer
    - `tokens_output` integer
    - `tokens_total` integer
    - `amount_paid` string, required
    - `amount_staking` string, required
    - `amount_total` string, required
    - `request_id` string
    - `api_key_id` integer
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `has_more` boolean, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-05-22** `6059f99c1875`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/changes/api/v1/billing/usage/month/get.md)

---

[API](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway.md) - [All operations](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/revisions/6059f99c1875?raw)