---
title: "Billing status"
method: GET
path: "/api/v1/broker/billing"
tags: ["Account & payment"]
---

# Billing status

`GET /api/v1/broker/billing`

## Request

- Base URL: `https://api.llm-broker.net`
- URL: `https://api.llm-broker.net/api/v1/broker/billing`
- Auth: API key in header `Authorization`

Balance, monthly spend, card, top-up rule. With the ast_sk_ key of the broker account.

## Response `200`

Status

- BrokerBillingStatus
  - `balance_chf` string
  - `billed_until` string, date, nullable
  - `billing` 'topup' | 'monthly'
  - `blocked_reason` string, nullable
  - `card` object, nullable
    - `brand` string
    - `expires` string
    - `last4` string
  - `card_setup_pending` boolean
  - `credit_limit_chf` string
  - `month_spent_chf` string
  - `topup` union: Only for billing=topup, otherwise false.
    - boolean
    - object
      - `amount_chf` string, nullable
      - `enabled` boolean
      - `threshold_chf` string, nullable

## Other responses

- `403`: Not a broker key
- `404`: Not a broker account

---

[API](https://skmtc.dev/llm-broker/apis/astrioncore-core-api.md) · [All operations](https://skmtc.dev/llm-broker/apis/astrioncore-core-api/llms.txt) · [OpenAPI document](https://skmtc.dev/llm-broker/apis/astrioncore-core-api/revisions/f85835487bf5?raw)