---
title: "Get Monthly Spending"
method: GET
path: "/api/v1/billing/spending"
tags: ["Billing"]
---

# Get Monthly Spending

`GET /api/v1/billing/spending`

## 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 monthly spending metrics for a year.

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

Parameters:
- year: Year to get spending for (defaults to current year)
- mode: 
  - gross: Only count usage charges
  - net: Include refunds in calculation

Returns 12 months of data including months with zero spending.

## Query parameters

- `year` integer: Year for spending data (defaults to current year)
- `mode` 'gross' | 'net': Spending calculation mode.

## Response `200`

Successful Response

- MonthlySpendingResponse: Response for GET /billing/spending.
  - `year` integer, required
  - `mode` 'gross' | 'net', required: Spending calculation mode.
  - `months` MonthlySpending[]: 12 months of spending data
    - `year` integer, required
    - `month` integer, required
    - `amount` string, required: Spending amount (negative)
    - `transaction_count` integer: Number of transactions
  - `total` string, required: Total spending for the year
  - `currency` string

## 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/spending/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)