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

# Get Billing Info

> Get billing period details and per-meter usage breakdown.



## OpenAPI

````yaml https://api.beeble.ai/developer-api-docs/openapi.json get /v1/account/billing
openapi: 3.1.0
info:
  title: Beeble Developer API
  description: API for SwitchX video-to-video compositing and media uploads.
  version: 1.0.0
servers:
  - url: https://api.beeble.ai
    description: Production
security:
  - apiKeyAuth: []
paths:
  /v1/account/billing:
    get:
      tags:
        - account
      summary: Get Billing Info
      description: Get billing period details and per-meter usage breakdown.
      operationId: get_account_billing_v1_account_billing_get
      parameters: []
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountBillingResponse'
components:
  schemas:
    AccountBillingResponse:
      properties:
        billing_period_start:
          anyOf:
            - type: integer
            - type: 'null'
          title: Billing Period Start
          description: Billing period start (Unix timestamp)
          examples:
            - 1711929600
        billing_period_end:
          anyOf:
            - type: integer
            - type: 'null'
          title: Billing Period End
          description: Billing period end (Unix timestamp)
          examples:
            - 1714521600
        prepaid_balance:
          anyOf:
            - type: number
            - type: 'null'
          title: Prepaid Balance
          description: Prepaid balance in dollars
          examples:
            - 247.5
        current_period_usage:
          anyOf:
            - type: number
            - type: 'null'
          title: Current Period Usage
          description: Total usage cost in current period in dollars
          examples:
            - 89.4
        meters:
          items:
            $ref: '#/components/schemas/models__account__MeterUsage'
          type: array
          title: Meters
          description: Per-meter usage breakdown
      type: object
      title: AccountBillingResponse
      description: Current billing period details including usage breakdown and balance.
    models__account__MeterUsage:
      properties:
        id:
          type: string
          title: Id
          description: Meter identifier (e.g. 'api_video_1080p')
        label:
          type: string
          title: Label
          description: Human-readable label
        unit:
          type: string
          title: Unit
          description: Unit type ('steps' or 'images')
        total_usage:
          type: integer
          title: Total Usage
          description: Total usage in current billing period
          examples:
            - 150
      type: object
      required:
        - id
        - label
        - unit
        - total_usage
      title: MeterUsage
      description: Usage for a single billing meter in the current period.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your [Developer API key](/api/authentication).

````