---
title: "Account balance, plan, this month's usage, recent invoices"
method: GET
path: "/api/v1/billing"
tags: ["billing"]
---

# Account balance, plan, this month's usage, recent invoices

`GET /api/v1/billing`

## Request

- Base URL: `https://www.callagent.pro`
- URL: `https://www.callagent.pro/api/v1/billing`
- Auth: HTTP bearer

## Response `200`

OK

- Billing: EUR throughout. `balance` is the prepay wallet; a plan, if any, is billed separately and carries `minutes_inc` included minutes.
  - `balance` number, required: EUR prepay balance — the same figure GET /overview reports as credits
  - `plan_name` string, required: Human name of the active plan, or the prepay label when there is none
  - `plan_id` integer, nullable, required: null when the account is pure prepay
  - `current_plan` object, nullable, required: The full plan record when subscribed; null on prepay. Same shape as an entry of `plans`.
  - `renew` string, nullable, required: Next renewal date; null on prepay
  - `price` number, required: Monthly plan price; 0 on prepay
  - `minutes_inc` integer, required: Minutes included per month
  - `minutes_used` integer, required: Included minutes consumed this period
  - `month_calls` integer, required
  - `month_minutes` integer, required
  - `month_spend` number, required
  - `manage_url` string, required: Browser URL where a human manages the subscription
  - `invoices` object[], required
    - `id` integer
    - `date` string
    - `amount` number
    - `status` string
  - `plans` object[], required: The catalogue; these ids are what POST /billing/plan accepts
    - `id` integer
    - `slug` string
    - `name` string
    - `price` number: EUR per month
    - `min` integer: Included minutes
    - `cpm` number: EUR per minute beyond the included ones
    - `feats` string[]
    - `tag` string: Badge such as Popular; empty string when none
  - `company` object, required: Invoice details on file
    - `type` string
    - `company` string
    - `vat` string
    - `regId` string
    - `addr` string
    - `email` string

## Other responses

- `401`: Missing or invalid Bearer key
- `429`: Too many requests — see the endpoint's rate limit tier (agent-api 120/min, agent-api-heavy 6/min, agent-api-secrets 10/min)

---

[API](https://skmtc.dev/callagent/apis/callagent-pro-agent-api.md) · [All operations](https://skmtc.dev/callagent/apis/callagent-pro-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/callagent/apis/callagent-pro-agent-api/revisions/38072cf8a24b?raw)