---
title: "Change billing mode or amount"
method: PATCH
path: "/api/v1/broker/billing"
tags: ["Account & payment"]
---

# Change billing mode or amount

`PATCH /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`

topup with amount 10/25/50 or monthly with limit 50/100/250. Requires a card on file.

## Request body

- BrokerUpdateBillingRequest
  - `amount` 10 | 25 | 50
  - `billing` 'topup' | 'monthly', required
  - `limit` 50 | 100 | 250

## Response `200`

New 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

- `400`: Invalid choice
- `409`: No card on file

---

[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)