---
title: "Billing Overview"
method: GET
path: "/account/billing/overview"
tags: ["account"]
---

# Billing Overview

`GET /account/billing/overview`

## Request

- Base URL: `https://api.beatra.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.beatra.ai/account/billing/overview`
- Auth: none declared

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- BillingOverviewResponse
  - `balance_credits` string, required
  - `expiring_credits` string, required
  - `non_expiring_credits` string, required
  - `next_expiry_at` string, date-time, nullable
  - `next_expiry_credits` string
  - `active_pass` ActivePassItem: The plan pass the account currently holds, if any. Validity is decided by the clock, not the balance: a customer who has spent every credit still holds the pass they paid for until it lapses. Tying the identity to `remaining_credits > 0` would make spending feel like losing something, which is exactly the wrong incentive on a prepaid product.
    - `term` string, required
    - `plan_level` string, required
    - `expires_at` string, date-time, required
    - `auto_renew` boolean, required
  - `active_subscription` AccountSubscriptionItem
    - `subscription_id` string, required
    - `status` string, required
    - `product_id` string, required
    - `term_id` string, required
    - `offer_id` string, required
    - `provider` string, required
    - `billing_interval` string, required
    - `current_period_start` string, date-time, required
    - `current_period_end` string, date-time, required
    - `cancel_at_period_end` boolean, required
    - `canceled_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `recent_grants` CreditGrantSummaryItem[], required
    - `grant_id` string, required
    - `source_type` string, required
    - `remaining_credits` string, required
    - `expires_at` string, date-time, nullable
    - `status` string, required
    - `created_at` string, date-time, required
  - `ledger` LedgerEntry[], required
    - `ledger_id` string, required
    - `ledger_type` string, required
    - `amount_credits` string, required
    - `balance_after_credits` string, required
    - `created_at` string, date-time, required
    - `task_id` string, nullable
    - `capability` string, nullable
    - `model` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/beatra/apis/agent-service-api.md) · [All operations](https://skmtc.dev/beatra/apis/agent-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/beatra/apis/agent-service-api/revisions/58e440556498?raw)