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

# Get the platform billing summary (Admin only)

> Credit LIMITS (caps) and consumption — NOT payments/cash. Returns active paid/grant
credit limits, total consumed, paying/granted org counts, and a breakdown by funding
source. Real money-in lives in the billing service, not cloud-api.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/admin/platform/billing-summary
openapi: 3.1.0
info:
  title: NEAR AI Cloud API
  description: >-
    NEAR AI Cloud API for private AI model inference and organization
    administration.
  contact:
    name: NEAR AI Team
    email: support@near.ai
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://cloud-api.near.ai
    description: NEAR AI Cloud
security:
  - session_token: []
  - api_key: []
tags:
  - name: Chat
    description: Chat completion endpoints for AI model inference
  - name: Images
    description: Image generation endpoints
  - name: Audio
    description: Audio transcription endpoints
  - name: Rerank
    description: Document reranking endpoints
  - name: Score
    description: Text similarity scoring endpoints
  - name: Privacy
    description: Privacy classification (PII span detection) endpoints
  - name: Models
    description: Public model catalog and information
  - name: Responses
    description: >-
      Stateless response inference (`store: false` only). Raw request/response
      content, response items, and history are not persisted. Clients must
      include any prior context in each request. Every successful Responses
      inference makes exactly one Chat Completions call. Only custom `function`
      tools are supported. They are client-managed: Cloud returns
      `function_call` items but never executes them; a later `store: false`
      request replays the individual call (the raw item from output is accepted)
      with its matching `function_call_output`, alongside caller-managed message
      history and the same function tool definitions. The minimal replay path
      also accepts assistant `message` text parts of type `output_text`, but not
      reasoning or arbitrary full `response.output` items. Server-executed tools
      (`web_search`, `web_context_search`, `file_search`, `code_interpreter`,
      `computer`, and remote `mcp`) and image-generation/editing models are
      rejected. The separate `POST /mcp` endpoint continues to expose its
      `web_search` tool independently of Responses; use `/v1/images/*` for image
      generation/editing. Existing completed-response gateway attestation is
      preserved best-effort: when the signature write succeeds, `GET
      /v1/signature/resp_*` retrieves signatures over SHA-256 request/response
      digests, never raw content. Interrupted streams create no `resp_*`
      attestation record or legacy disconnect fallback. Conversations, response
      history, and file input are rejected.
  - name: Organizations
    description: Organization management
  - name: Organization Members
    description: Organization member and invitation management
  - name: Workspaces
    description: Workspace and API key management
  - name: Users
    description: User profile and token management
  - name: Invitations
    description: Token-based invitation handling
  - name: Usage
    description: Usage tracking and billing information
  - name: Reporting
    description: Read-only customer usage reporting
  - name: Billing
    description: Billing costs endpoint (HuggingFace integration)
  - name: Staking Farm
    description: House of Stake farm credit configuration and synchronization
  - name: Health
    description: Health check endpoints
  - name: Attestation
    description: Attestation and verification endpoints
  - name: Gateway
    description: Model gateway integration endpoints
  - name: Admin
    description: Administrative endpoints (admin access required)
  - name: Services
    description: Public platform services (e.g. web_search pricing)
paths:
  /v1/admin/platform/billing-summary:
    get:
      tags:
        - Admin
      summary: Get the platform billing summary (Admin only)
      description: >-
        Credit LIMITS (caps) and consumption — NOT payments/cash. Returns active
        paid/grant

        credit limits, total consumed, paying/granted org counts, and a
        breakdown by funding

        source. Real money-in lives in the billing service, not cloud-api.
      operationId: get_billing_summary
      responses:
        '200':
          description: Billing summary retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillingSummary'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - session_token: []
components:
  schemas:
    BillingSummary:
      type: object
      description: >-
        Platform billing summary — credit LIMITS (caps) and consumption.


        These are spend-limit ceilings from `organization_limits_history`, NOT
        payments

        or cash received. Real money-in (Stripe top-ups) lives in the billing
        service

        (nearai-cloud-ui), not in cloud-api.
      required:
        - generated_at
        - active_paid_credit_limit_usd
        - active_grant_credit_limit_usd
        - total_consumed_usd
        - inference_consumed_usd
        - service_consumed_usd
        - paying_org_count
        - granted_org_count
        - by_source
      properties:
        active_grant_credit_limit_usd:
          type: number
          format: double
          description: Sum of active grant-type spend limits (caps), USD
        active_paid_credit_limit_usd:
          type: number
          format: double
          description: Sum of active payment-type spend limits (caps), USD
        by_source:
          type: array
          items:
            $ref: '#/components/schemas/BillingSourceBreakdown'
        generated_at:
          type: string
          format: date-time
        granted_org_count:
          type: integer
          format: int64
        inference_consumed_usd:
          type: number
          format: double
          description: All-time inference consumed cost, USD (organization_usage_log)
        paying_org_count:
          type: integer
          format: int64
        service_consumed_usd:
          type: number
          format: double
          description: >-
            All-time service consumed cost, USD (organization_service_usage_log,
            e.g. web_search)
        total_consumed_usd:
          type: number
          format: double
          description: >-
            All-time consumed cost across all orgs, USD — **all usage** (from

            organization_balance: inference + services). `inference_consumed_usd
            +

            service_consumed_usd` reconcile to this.
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
    BillingSourceBreakdown:
      type: object
      description: Active credit limit by funding source (caps, not payments).
      required:
        - source
        - paid_credit_limit_usd
        - org_count
      properties:
        org_count:
          type: integer
          format: int64
        paid_credit_limit_usd:
          type: number
          format: double
          description: Sum of active payment-type spend limits (caps) for this source, USD
        source:
          type: string
    ErrorDetail:
      type: object
      required:
        - message
        - type
      properties:
        code:
          type:
            - string
            - 'null'
        message:
          type: string
        param:
          type:
            - string
            - 'null'
        type:
          type: string
  securitySchemes:
    session_token:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT access token for user authentication (Authorization: Bearer
        <jwt_token>). Create via POST /users/me/access_tokens.
    api_key:
      type: http
      scheme: bearer
      bearerFormat: api_key
      description: 'API key for programmatic access (Authorization: Bearer sk-<api_key>)'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.