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

# Plan & billing overview for the billing organization



## OpenAPI

````yaml /openapi/v3.yaml get /api/v2/billing/account
openapi: 3.1.0
info:
  title: Semicola Exchange API
  version: 3.0.0-preview
  description: >-
    Platform endpoints of Semicola: sign-in and accounts, members and keys,
    billing, notifications, the Semi assistant (chat stream, confirmations,
    conversations), the MCP App widget host and realtime feeds. Typed agent
    tools live on the MCP server at /mcp/v3.
servers:
  - url: https://api.semicola.com
security:
  - bearerAuth: []
  - sessionCookie: []
tags:
  - name: Auth
  - name: Accounts
  - name: Billing
  - name: Notifications
  - name: Assistant
  - name: Widget host
  - name: Realtime
  - name: Demo
paths:
  /api/v2/billing/account:
    get:
      tags:
        - Billing
      summary: Plan & billing overview for the billing organization
      operationId: getBillingAccount
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    anyOf:
                      - type: object
                        properties:
                          billingCustomerId:
                            type: integer
                            exclusiveMinimum: 0
                            maximum: 9007199254740991
                          organizationName:
                            type: string
                          handledAtOrganization:
                            type: boolean
                          posture:
                            type: string
                            enum:
                              - PREPAY
                              - CREDIT
                          creditLimitMinor:
                            anyOf:
                              - type: string
                                pattern: ^-?\d+$
                              - type: 'null'
                          currency:
                            type: string
                            pattern: ^[A-Z]{3}$
                          verified:
                            type: boolean
                          standing:
                            type: string
                            enum:
                              - good
                              - needs_attention
                          availableBalanceMinor:
                            anyOf:
                              - type: string
                                pattern: ^-?\d+$
                              - type: 'null'
                          plan:
                            type: object
                            properties:
                              planKey:
                                type: string
                              label:
                                type: string
                              includedIus:
                                type: string
                                pattern: ^-?\d+(\.\d{1,6})?$
                              commitmentMinor:
                                type: string
                                pattern: ^-?\d+$
                              rateCardVersion:
                                type: string
                            required:
                              - planKey
                              - label
                              - includedIus
                              - commitmentMinor
                              - rateCardVersion
                            additionalProperties: false
                          nextAction:
                            type: object
                            properties:
                              type:
                                type: string
                                enum:
                                  - ACCEPT_TOS
                                  - ACCEPT_GOVERNING_AGREEMENT
                                  - SELECT_IU_PLAN
                                  - CONTACT_SUPPORT
                                  - ADD_BILLING_INFO
                                  - ADD_PAYMENT_METHOD
                                  - FUND_PREPAY
                                  - APPLY_FOR_CREDIT
                                  - RESOLVE_HOLD
                                  - UPDATE_PAYMENT_METHOD
                                  - NONE
                              step:
                                anyOf:
                                  - type: integer
                                    minimum: 1
                                    maximum: 4
                                  - type: 'null'
                              totalSteps:
                                type: number
                                const: 4
                              label:
                                type: string
                            required:
                              - type
                              - step
                              - totalSteps
                              - label
                            additionalProperties: false
                          usageThisPeriod:
                            type: object
                            properties:
                              ius:
                                type: string
                                pattern: ^-?\d+(\.\d{1,6})?$
                              topActivity:
                                type:
                                  - string
                                  - 'null'
                            required:
                              - ius
                              - topActivity
                            additionalProperties: false
                        required:
                          - billingCustomerId
                          - organizationName
                          - handledAtOrganization
                          - posture
                          - creditLimitMinor
                          - currency
                          - verified
                          - standing
                          - availableBalanceMinor
                          - plan
                          - nextAction
                          - usageThisPeriod
                        additionalProperties: false
                      - type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                          message:
                            type: string
                          field:
                            type: string
                          details: {}
                        required:
                          - code
                          - message
                        additionalProperties: false
                      - type: 'null'
                required:
                  - data
                  - error
                additionalProperties: false
        default:
          description: >-
            Error envelope `{data: null, error: {code, message, field?,
            details?}}`.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key or OAuth access token.
    sessionCookie:
      type: apiKey
      in: cookie
      name: sc_session

````