AnomalyArmor Billing API

openapi: 3.2.0
info:
  title: Anomalyarmor Ai Billing API
  version: 1.0.0
  contact:
    name: AnomalyArmor Support
    url: https://anomalyarmor.ai/support
  license:
    name: Proprietary
  description: 'Operations tagged billing across 3 of this provider''s published API definitions: anomalyarmor.ai-openapi.json, app.anomalyarmor.ai-openapi.json, docs.anomalyarmor.ai-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: http://localhost:8000
  description: Development server
- url: https://api.anomalyarmor.ai
  description: Production server
tags:
- name: Billing
paths:
  /api/v1/billing/estimate-cost:
    post:
      tags:
      - Billing
      summary: Estimate Operation Cost
      description: 'Estimate cost for an AI operation before execution.


        This endpoint helps users understand the cost implications before

        running expensive AI operations. The estimate includes:

        - Total cost to be charged

        - Platform margin based on subscription tier

        - Current wallet balance

        - Whether sufficient funds are available'
      operationId: estimate_operation_cost_api_v1_billing_estimate_cost_post
      parameters:
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostEstimateRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/billing/usage/summary:
    get:
      tags:
      - Billing
      summary: Get Usage Summary
      description: 'Get usage summary for a time period.


        Returns aggregated transaction data including:

        - Total deposits

        - Total AI operation costs

        - Total refunds

        - Total adjustments

        - Transaction count'
      operationId: get_usage_summary_api_v1_billing_usage_summary_get
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date-time
          description: Start of period
          title: Start Date
        description: Start of period
      - name: end_date
        in: query
        required: true
        schema:
          type: string
          format: date-time
          description: End of period
          title: End Date
        description: End of period
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/billing/usage/comprehensive-summary:
    get:
      tags:
      - Billing
      summary: Get Comprehensive Usage Summary
      description: 'Get comprehensive usage summary including tables, assets, and subscription info.


        This endpoint provides a complete overview of usage metrics that the frontend

        billing components expect.'
      operationId: get_comprehensive_usage_summary_api_v1_billing_usage_comprehensive_summary_get
      parameters:
      - name: start_date
        in: query
        required: true
        schema:
          type: string
          format: date-time
          description: Start of period
          title: Start Date
        description: Start of period
      - name: end_date
        in: query
        required: true
        schema:
          type: string
          format: date-time
          description: End of period
          title: End Date
        description: End of period
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/billing/usage/tables:
    get:
      tags:
      - Billing
      summary: Get Table Usage
      description: 'Get current table usage and limits for the company.


        TECH-716: Updated to include feature breakdown for unified pool metering.'
      operationId: get_table_usage_api_v1_billing_usage_tables_get
      parameters:
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/billing/usage/tables/limit-checks:
    post:
      tags:
      - Billing
      summary: Create Table Limit Check
      description: Check if company can monitor another table.
      operationId: create_table_limit_check_api_v1_billing_usage_tables_limit_checks_post
      parameters:
      - name: table_id
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          title: Table Id
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/billing/usage/intelligence:
    get:
      tags:
      - Billing
      summary: Get Intelligence Usage
      description: 'Get current intelligence query usage and limits for the company.


        Returns:

        StandardResponse with data containing:

        - current_usage: Current monthly usage count

        - query_limit: Maximum queries allowed per month

        - is_unlimited: Whether tier has unlimited queries

        - remaining_queries: Queries remaining this month

        - percentage_used: Percentage of limit used (0-100)

        - tier_name: Subscription tier name'
      operationId: get_intelligence_usage_api_v1_billing_usage_intelligence_get
      parameters:
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/billing/usage/ai-spend:
    get:
      tags:
      - Billing
      summary: Get Ai Spend Usage
      description: 'Get the company''s month-to-date AI dollar spend vs its cost ceiling.


        TECH-987.3: backs the free-tier AI spend ($/ceiling) meter. Reads the

        per-company ceiling spend from ``AICostCeilingService`` (the same source the

        enforcement path uses). ``ceiling`` is null for uncapped (paid) plans.


        Returns:

        StandardResponse with data containing:

        - spend: month-to-date AI spend in USD

        - ceiling: monthly ceiling in USD (null = uncapped)

        - is_unlimited: True when there is no ceiling (paid plans)

        - percentage_used: 0-100 (0 when uncapped)

        - enforced: whether the ceiling currently blocks (rollout flag)'
      operationId: get_ai_spend_usage_api_v1_billing_usage_ai_spend_get
      parameters:
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/billing/usage/assets:
    get:
      tags:
      - Billing
      summary: Get Asset Usage
      description: 'Get current asset (database connection) usage and limits for the company.


        TECH-576: Added for billing page asset usage display.


        Returns:

        StandardResponse with data containing:

        - current: Current number of active assets

        - limit: Maximum assets allowed for subscription tier

        - is_unlimited: Whether tier has unlimited assets

        - can_add: Whether user can add more assets

        - percentage: Percentage of limit used (0-100)

        - tier_name: Subscription tier name'
      operationId: get_asset_usage_api_v1_billing_usage_assets_get
      parameters:
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/billing/invoices:
    get:
      tags:
      - Billing
      summary: List Invoices
      description: 'List invoices for the current company.


        TECH-585: Fetches invoice history from Stripe.


        Returns paginated list of paid invoices with:

        - Invoice number and ID

        - Amount and currency

        - Payment date

        - Links to hosted invoice and PDF'
      operationId: list_invoices_api_v1_billing_invoices_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Number of invoices to return
          default: 20
          title: Limit
        description: Number of invoices to return
      - name: starting_after
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Cursor for pagination (invoice ID)
          title: Starting After
        description: Cursor for pagination (invoice ID)
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/billing/invoices/{invoice_id}:
    get:
      tags:
      - Billing
      summary: Get Invoice
      description: 'Get details for a specific invoice.


        TECH-585: Retrieves full invoice details including line items from Stripe.


        Args:

        invoice_id: Stripe invoice ID (e.g., ''in_xxx'')


        Returns:

        Invoice details with line items'
      operationId: get_invoice_api_v1_billing_invoices__invoice_id__get
      parameters:
      - name: invoice_id
        in: path
        required: true
        schema:
          type: string
          title: Invoice Id
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/billing/invoices/{invoice_id}/pdf:
    get:
      tags:
      - Billing
      summary: Get Invoice Pdf
      description: 'Redirect to the Stripe-hosted invoice PDF.


        TECH-585: Provides download link for invoice PDF.


        Args:

        invoice_id: Stripe invoice ID


        Returns:

        Redirect to Stripe PDF URL'
      operationId: get_invoice_pdf_api_v1_billing_invoices__invoice_id__pdf_get
      parameters:
      - name: invoice_id
        in: path
        required: true
        schema:
          type: string
          title: Invoice Id
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CostEstimateRequest:
      properties:
        operation_type:
          type: string
          maxLength: 50
          minLength: 1
          title: Operation Type
        model:
          type: string
          maxLength: 50
          minLength: 1
          title: Model
        estimated_tokens:
          anyOf:
          - type: integer
            maximum: 1000000.0
            minimum: 1.0
          - type: 'null'
          title: Estimated Tokens
        asset_id:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          title: Asset Id
      type: object
      required:
      - operation_type
      - model
      title: CostEstimateRequest
      description: Schema for requesting cost estimate.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    StandardResponse:
      properties:
        success:
          type: boolean
          title: Success
        data:
          anyOf:
          - {}
          - type: 'null'
          title: Data
        message:
          anyOf:
          - type: string
          - type: 'null'
          title: Message
        error:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
        meta:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Meta
      type: object
      required:
      - success
      title: StandardResponse
      description: Standard API response wrapper.
x-refined-from:
- anomalyarmor.ai-openapi.json
- app.anomalyarmor.ai-openapi.json
- docs.anomalyarmor.ai-openapi.json