---
title: "Get a billing account"
method: GET
path: "/api/public/billing-accounts/{billingAccountId}"
tags: ["Billing accounts"]
---

# Get a billing account

`GET /api/public/billing-accounts/{billingAccountId}`

## Request

- Base URL: `https://charts.basedash.com`
- URL: `https://charts.basedash.com/api/public/billing-accounts/{billingAccountId}`
- Auth: HTTP bearer

Gets a billing account. Requires admin access to the account's owner organization.

## Path parameters

- `billingAccountId` string, required: Billing account ID

## Response `200`

Billing account retrieved successfully

- object
  - `data` PublicBillingAccount, required
    - `id` string, required: Billing account ID
    - `name` string, required: Name of the billing account
    - `isActive` boolean, required: Whether the billing account is active. Attached organizations lose paid coverage when the account is inactive.
    - `ownerOrganizationId` string, required: Organization whose admins manage this billing account. Attach and detach operations require admin access to this organization.
    - `subscriptionStatus` string, nullable, required: Stripe subscription status for the billing account, or null when billing is managed outside Stripe.
    - `platformFeeWaived` boolean, required: Whether the per-organization platform fee is waived for this account.
    - `aiUsageIncludedCreditsCents` integer, required: Included AI usage credits in cents, pooled across all attached organizations per billing period.
    - `allowOnDemandAiUsage` boolean, required: Whether the billing account can continue using AI beyond its pooled included credits. This is a hard gate for every attached organization in addition to each organization’s own setting.
    - `aiUsageOverageLimitCents` integer, nullable, required: Maximum AI usage overage for the whole billing account in cents. This hard cap applies across all attached organizations in addition to any organization-level cap. Null means no account limit.
    - `billingPeriodStart` string, nullable, required: Billing period start
    - `billingPeriodEnd` string, nullable, required: Billing period end
    - `organizationCount` integer, required: Number of organizations attached to this billing account
    - `createdAt` string, required: Creation timestamp

## Other responses

- `401`: Unauthorized - Missing or invalid API key
- `404`: Not found - Billing account not found or no admin access
- `429`: Rate limit exceeded - Too many requests
- `500`: Internal server error

---

[API](https://skmtc.dev/basedash/apis/basedash-public-api.md) - [All operations](https://skmtc.dev/basedash/apis/basedash-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/basedash/apis/basedash-public-api/revisions/efb9d40bc6f7?raw)