---
title: "Get LLM token billing status"
method: GET
path: "/v1/billing/llm-token-billing"
tags: ["Billing"]
---

# Get LLM token billing status

`GET /v1/billing/llm-token-billing`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/billing/llm-token-billing`
- Auth: HTTP bearer

Returns whether LLM token billing is enabled, optional Stripe billing credit balance (metered scope), and estimated cycle usage from the upcoming invoice—including per-line metered rows when Stripe returns them (amounts; quantities such as tokens when present).

## Response `200`

LLM token billing status

- LlmTokenBillingStatus
  - `enabled` boolean, required
  - `billing_model` 'postpaid_metered', required: Usage accrues on the Stripe subscription and is invoiced at the end of the billing period. `credit_balance` is Stripe's prepaid credit-grant balance, which is 0 unless a credit grant was issued; a 0 there does not block inference.
  - `inference_allowed` boolean, required: Enabled and the subscription is not canceled/unpaid/expired.
  - `subscription_status` 'active' | 'inactive'
  - `credit_balance` LlmCreditBalance
    - `available_cents` integer
    - `ledger_cents` integer
    - `used_cents` integer
    - `currency` string
  - `billing_cycle_usage` LlmBillingCycleUsage: Accrued LLM charges for the current Stripe subscription period (upcoming invoice).
    - `period_start` string, date-time, nullable
    - `period_end` string, date-time, nullable
    - `accrued_usage_cents` integer
    - `currency` string
    - `metered_lines` LlmMeteredInvoiceLine[]
      - `description` string, nullable
      - `amount_cents` integer
      - `quantity` number, nullable: Billed usage units when Stripe returns quantity (e.g. tokens).
      - `price_nickname` string, nullable
  - `active_subscription_count` integer
  - `subscription_ids` string[]
  - `warning` string

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)