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

# Current billing cycle summary (tier, included credit, used, overage, status)

> **Token scope:** `account` · `org` — read-only tokens allowed.



## OpenAPI

````yaml /openapi/org.json get /orgs/{orgId}/billing
openapi: 3.1.0
info:
  title: InstaCloud API — Organization level
  version: 0.1.0
  description: >-
    Endpoints under `/orgs/{orgId}`: members, projects, billing, domains.
    Callable with an account-wide token or a token bound to that organization.


    Generated from the platform's own OpenAPI document
    (https://api.instacloud.com/openapi.json); see the [API
    overview](/reference/api/overview) for authentication and token scopes.
servers:
  - url: https://api.instacloud.com
    description: InstaCloud
security:
  - bearerAuth: []
tags:
  - name: Organization
    description: 'The organization itself: name, members, invitations.'
  - name: Projects
    description: Projects inside an organization.
  - name: Audit
    description: The project's event timeline, including agent-ingested events.
  - name: Domains
    description: >-
      Domains bought through InstaCloud, bring-your-own zones and their DNS
      records.
  - name: Billing
    description: Usage, cycles, invoices and credits.
paths:
  /orgs/{orgId}/billing:
    get:
      tags:
        - Billing
      summary: >-
        Current billing cycle summary (tier, included credit, used, overage,
        status)
      description: '**Token scope:** `account` · `org` — read-only tokens allowed.'
      operationId: getBilling
      parameters:
        - schema:
            format: uuid
            type: string
          in: path
          name: orgId
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillingSummary'
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    BillingSummary:
      type: object
      properties:
        tier:
          type: string
          enum:
            - free
            - pro
            - team
            - enterprise
        billingStatus:
          type: string
          enum:
            - active
            - suspended
        cycleStart:
          format: date-time
          type: string
        cycleEnd:
          format: date-time
          type: string
        includedUsd:
          description: >-
            tier allowance for the cycle (free $5 / pro $20 / team $0 — the plan
            fee is flat and usage bills from the first cent / enterprise per
            deal, $0 default); platform-configurable
          type: number
        usedUsd:
          type: number
        overageUsd:
          type: number
        status:
          type: string
          enum:
            - active
            - suspended
        subscriptionStatus:
          description: >-
            Stripe subscription status (active/past_due/canceled/…); null if no
            paid subscription.
          type:
            - string
            - 'null'
        caps:
          description: >-
            this plan's resource ceilings for a compute service (vCPU / MB /
            volume Gi; managed redis/mysql/mongodb read the compute row) and for
            a postgres service (millicores / MiB / volume Gi) — the same rows
            the per-service `cap` fields return. A NEW service is born at them
            (cpu, memory and, since 2026-09-12, its volume), and an existing one
            may be raised to them. Read them from here to prefill a create form
            before any service exists; they move with the plan and with env
            overrides per deployment, so never hardcode a tier's numbers.
          type: object
          properties:
            compute:
              type: object
              properties:
                cpu:
                  type: integer
                memoryMb:
                  type: integer
                volumeGib:
                  type: integer
              required:
                - cpu
                - memoryMb
                - volumeGib
            db:
              type: object
              properties:
                cpuMilli:
                  type: integer
                memoryMib:
                  type: integer
                volumeGib:
                  type: integer
              required:
                - cpuMilli
                - memoryMib
                - volumeGib
          required:
            - compute
            - db
    Error:
      type: object
      properties:
        error:
          type: string
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Session access JWT or an API token (`insta_<prefix>_<secret>`).

````