---
title: "List billing accounts"
method: GET
path: "/api/public/billing-accounts"
tags: ["Billing accounts"]
---

# List billing accounts

`GET /api/public/billing-accounts`

## Request

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

Lists billing accounts managed by the authenticated user (accounts whose owner organization the user administers). Billing accounts are created by Basedash — contact support to set one up.

## Response `200`

Billing accounts 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
- `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)