> ## Documentation Index
> Fetch the complete documentation index at: https://basedash.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List billing accounts

> 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.



## OpenAPI

````yaml https://charts.basedash.com/api/public/openapi get /api/public/billing-accounts
openapi: 3.1.0
info:
  title: Basedash Public API
  version: 0.0.0
  description: >-
    API for programmatic access to Basedash features. Use API keys for
    authentication.
  contact:
    name: Basedash Support
    url: https://basedash.com
    email: support@basedash.com
servers:
  - url: https://charts.basedash.com
    description: Production
security: []
tags:
  - name: Organizations
    description: Manage organizations
  - name: Groups
    description: Manage organization groups and memberships
  - name: Data Sources
    description: Manage database connections and data sources
  - name: MCP servers
    description: Manage MCP server data sources
  - name: Insights
    description: Manage generated insights
  - name: Automations
    description: Manage automations and automation runs
  - name: Skills
    description: Manage organization skills
  - name: Definitions
    description: Manage reusable SQL definitions
  - name: Dashboards
    description: Manage dashboards and their tabs
  - name: Charts
    description: Manage charts and their SQL queries
  - name: Chats
    description: >-
      Chat with the Basedash AI agent about your data. Start a chat by sending a
      message, then continue the conversation with follow-up messages. The
      assistant responds asynchronously: pass the `wait` query parameter to
      receive the finished response in the same request, or poll the assistant
      message (or stream its events) after an HTTP 202. Chats created through
      the API are not shown in the Basedash app.
paths:
  /api/public/billing-accounts:
    get:
      tags:
        - Billing accounts
      summary: List billing accounts
      description: >-
        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.
      responses:
        '200':
          description: Billing accounts retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/PublicBillingAccount'
                required:
                  - data
        '401':
          description: Unauthorized - Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limit exceeded - Too many requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    PublicBillingAccount:
      type: object
      properties:
        id:
          type: string
          description: Billing account ID
        name:
          type: string
          description: Name of the billing account
        isActive:
          type: boolean
          description: >-
            Whether the billing account is active. Attached organizations lose
            paid coverage when the account is inactive.
        ownerOrganizationId:
          type: string
          description: >-
            Organization whose admins manage this billing account. Attach and
            detach operations require admin access to this organization.
        subscriptionStatus:
          type:
            - string
            - 'null'
          description: >-
            Stripe subscription status for the billing account, or null when
            billing is managed outside Stripe.
        platformFeeWaived:
          type: boolean
          description: >-
            Whether the per-organization platform fee is waived for this
            account.
        aiUsageIncludedCreditsCents:
          type: integer
          description: >-
            Included AI usage credits in cents, pooled across all attached
            organizations per billing period.
        allowOnDemandAiUsage:
          type: boolean
          description: >-
            Whether attached organizations can continue using AI beyond the
            pooled included credits.
        aiUsageOverageLimitCents:
          type:
            - integer
            - 'null'
          description: Maximum pooled AI usage overage in cents. Null means no limit.
        billingPeriodStart:
          type:
            - string
            - 'null'
          description: Billing period start
        billingPeriodEnd:
          type:
            - string
            - 'null'
          description: Billing period end
        organizationCount:
          type: integer
          description: Number of organizations attached to this billing account
        createdAt:
          type: string
          description: Creation timestamp
      required:
        - id
        - name
        - isActive
        - ownerOrganizationId
        - subscriptionStatus
        - platformFeeWaived
        - aiUsageIncludedCreditsCents
        - allowOnDemandAiUsage
        - aiUsageOverageLimitCents
        - billingPeriodStart
        - billingPeriodEnd
        - organizationCount
        - createdAt
    ErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/ApiError'
      required:
        - error
    RateLimitErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/RateLimitError'
      required:
        - error
    ApiError:
      type: object
      properties:
        title:
          type: string
          description: Error type identifier
        detail:
          type: string
          description: Human-readable error description
      required:
        - title
        - detail
    RateLimitError:
      allOf:
        - $ref: '#/components/schemas/ApiError'
        - type: object
          properties:
            title:
              type: string
              enum:
                - RateLimitExceeded
            retryAfterMs:
              type: number
              description: Milliseconds until the rate limit window resets
          required:
            - retryAfterMs
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key authentication using Bearer token format: `Bearer
        <basedash_api_key>`

````