---
title: "Get credit balance and plan usage"
method: GET
path: "/api/account/balance"
---

# Get credit balance and plan usage

`GET /api/account/balance`

## Request

- Base URL: `https://www.trezalabs.com`
- URL: `https://www.trezalabs.com/api/account/balance`
- Auth: HTTP bearer

Current prepaid credit balance, plan usage, and purchasable credit packs. Accepts a scoped API key (any pipelines scope), an MCP OAuth access token, or a session bearer. Use it to budget runs before starting them; when the balance is low, hand topUpUrl to a human, since credits are purchased by a signed-in human.

## Response `200`

Balance summary

- object
  - `balanceUsd` number
  - `enforced` boolean: False when this account runs free (credits not enforced).
  - `markup` number: Multiplier applied to estimated provider cost when charging the balance.
  - `typicalVideoChargeUsd` number
  - `approxVideosRemaining` integer
  - `plan` object, nullable
    - `name` string
    - `status` string
    - `requestsThisPeriod` integer
    - `includedRequests` integer
    - `overLimit` boolean
  - `packs` object[]
    - `id` string
    - `priceUsd` number
    - `creditsUsd` number
    - `label` string
  - `topUpUrl` string, uri
  - `x402` object: Present when the deployment supports agent-native x402 top-ups.
    - `url` string, uri
    - `topUpPerCallUsd` number
    - `network` string: The first network the x402 endpoints accept: eip155:8453 (Base).
    - `networks` string[]: Every network a payment may arrive on, Base first: eip155:8453 and solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp. A Base wallet and a Solana wallet are separate accounts.
    - `video` object: Present when pay-per-video is on: POST /api/x402/video buys one clip for one payment, with no account. sizes lists the default model's clip lengths; GET that URL for every model and price.
      - `url` string, uri
      - `fromUsd` number
      - `sizes` object[]
        - `seconds` number
        - `priceUsd` number

## Other responses

- `401`: Missing or invalid bearer token
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/trezalabs/apis/treza-pipelines-api.md) · [All operations](https://skmtc.dev/trezalabs/apis/treza-pipelines-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trezalabs/apis/treza-pipelines-api/revisions/a76574c1731b?raw)