---
title: "Get Billing Mode History"
method: GET
path: "/billing/billing_mode/history"
tags: ["/billing"]
---

# Get Billing Mode History

`GET /billing/billing_mode/history`

## Request

- Base URL: `https://api.contextual.ai/v1`
- URL: `https://api.contextual.ai/v1/billing/billing_mode/history`
- Auth: HTTP bearer

Get the billing mode history for a tenant for a specific month.

Args: request: Request object containing year and month with validation user_context: User context with tenant admin permissions

Returns: Billing mode history records for the specified month and year Returns at least one entry which is the mode of the first date of the given month, with potential mode changes in the middle of the month. If no record found, defaults to LEGACY mode.

## Query parameters

- `year` integer, required
- `month` integer, required

## Response `200`

Successful Response

- BillingModeHistoryResponse: Response to GET /billing/billing_mode/history request
  - `billing_modes` BillingModeHistoryEntry[], required: List of billing mode entries for the specified month
    - `date` string, date, required: Date (yyyy-mm-dd) when the billing mode became effective
    - `billing_mode` 'ON_DEMAND_PREPAID' | 'ON_DEMAND_PAY_ARREARS' | 'PROVISION_THROUGHPUT' | 'LEGACY', required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `4abdda722de9`: 1 info
  - endpoint added
- **2026-01-13** `ca7f807eec8b`: 1 breaking
  - api path removed without deprecation
- **2025-10-28** `c8152db45500`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/contextualai/apis/endpoints/changes/billing/billing_mode/history/get.md)

---

[API](https://skmtc.dev/contextualai/apis/endpoints.md) - [All operations](https://skmtc.dev/contextualai/apis/endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/contextualai/apis/endpoints/revisions/4abdda722de9?raw)