---
title: "Get billing account info"
method: GET
path: "/billing_account"
tags: ["Billing"]
---

# Get billing account info

`GET /billing_account`

Retrieve the billing account of the authenticated customer. The billing account is automatically resolved from the authenticated user's customer record.

## Response `200`

The billing account information.

- BillingManagerAccount
  - `id` string, uuid — The unique identifier of the account.
  - `customer_id` string, uuid — The unique identifier of the associated customer. Returned from the `GET /customers` response.
  - `name` string — The display name of the billing account.
  - `detail` string — A human-readable note describing the purpose of this account.
  - `plan_type` 'free' | 'basic' | 'professional' | 'unlimited' — The plan tier of the billing account. Determines resource creation limits.
  - `plan_status` 'active' | 'canceling' — The subscription plan status of the billing account. Indicates whether the plan is actively running or scheduled for cancellation.
  - `balance_credit` integer — The credit balance of the account in micros (1 USD = 1,000,000).
  - `balance_token` integer — The token balance of the account.
  - `payment_type` '' | 'prepaid' — The type of payment associated with the account.
  - `payment_method` '' | 'credit card' — The method of payment used for the account.
  - `paddle_subscription_id` string — The Paddle subscription identifier for this billing account. Populated automatically when a Paddle subscription is created via Paddle webhook processing. Read-only — not settable via API. Present only when the account has an active Paddle subscription.
  - `paddle_customer_id` string — The Paddle customer identifier for this billing account. Populated automatically when a Paddle customer record is created via Paddle webhook processing. Read-only — not settable via API. Present only when the account has a linked Paddle customer.
  - `tm_last_topup` string, date-time — The timestamp of the last token top-up.
  - `tm_next_topup` string, date-time — The timestamp of the next scheduled token top-up.
  - `tm_create` string, date-time — The timestamp when the account was created.
  - `tm_update` string, date-time — The timestamp when the account was last updated.
  - `tm_delete` string, date-time — The timestamp when the account was deleted, if applicable.

## Other responses

- `401` — Authentication required (UNAUTHENTICATED).
- `500` — Internal error (INTERNAL).

---

[API](https://skmtc.net/voipbin/apis/voipbin-api.md) · [All operations](https://skmtc.net/voipbin/apis/voipbin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voipbin/voipbin-api/versions/79e779080bcc/schema)