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

# Get resolved workspace billing notification view (override + account)



## OpenAPI

````yaml get /v2/billing/notifications/workspaces/{workspaceId}/config
openapi: 3.0.0
info:
  title: Topograph
  description: The Topograph API
  version: '0.1'
  contact: {}
servers:
  - url: https://api.topograph.co
security:
  - x-api-key: []
tags: []
paths:
  /v2/billing/notifications/workspaces/{workspaceId}/config:
    get:
      tags:
        - Billing Notifications
      summary: Get resolved workspace billing notification view (override + account)
      operationId: BillingNotificationsController_getWorkspaceOverride_v2
      parameters:
        - name: workspaceId
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceBillingNotificationViewDto'
      security:
        - x-api-key: []
components:
  schemas:
    WorkspaceBillingNotificationViewDto:
      type: object
      properties:
        accountConfig:
          description: Fully resolved account-level config (defaults merged).
          allOf:
            - $ref: '#/components/schemas/ResolvedBillingNotificationConfigDto'
        workspaceOverride:
          description: >-
            Raw workspace-override row, or null if the workspace inherits
            everything.
          nullable: true
          type: object
          allOf:
            - $ref: '#/components/schemas/BillingNotificationWorkspaceOverrideDto'
      required:
        - accountConfig
    ResolvedBillingNotificationConfigDto:
      type: object
      properties:
        lowBalanceEnabled:
          type: boolean
          description: Master toggle for low-balance notifications.
          example: false
        lowBalanceEmailEnabled:
          type: boolean
          description: Route low-balance notifications via email.
          example: true
        lowBalanceWebhookEnabled:
          type: boolean
          description: Route low-balance notifications via webhook.
          example: true
        lowBalanceTiers:
          description: Resolved low-balance tiers.
          type: array
          items:
            $ref: '#/components/schemas/LowBalanceTierDto'
        globalHighUsageEnabled:
          type: boolean
          description: >-
            Master toggle for global (account-aggregate) high-usage
            notifications.
          example: false
        globalHighUsageEmailEnabled:
          type: boolean
          description: Route global high-usage notifications via email.
          example: true
        globalHighUsageWebhookEnabled:
          type: boolean
          description: Route global high-usage notifications via webhook.
          example: true
        globalHighUsagePeriodMinutes:
          type: number
          description: Rolling window, in minutes, for global high-usage evaluation.
          example: 1440
        globalHighUsageTiers:
          description: Resolved global high-usage tiers.
          type: array
          items:
            $ref: '#/components/schemas/HighUsageTierDto'
        highUsageEnabled:
          type: boolean
          description: Master toggle for per-workspace high-usage notifications.
          example: false
        highUsageEmailEnabled:
          type: boolean
          description: Route per-workspace high-usage notifications via email.
          example: true
        highUsageWebhookEnabled:
          type: boolean
          description: Route per-workspace high-usage notifications via webhook.
          example: true
        highUsagePeriodMinutes:
          type: number
          description: Rolling window, in minutes, for per-workspace high-usage evaluation.
          example: 1440
        highUsageTiers:
          description: >-
            Resolved per-workspace high-usage tiers (applied as defaults to
            every workspace).
          type: array
          items:
            $ref: '#/components/schemas/HighUsageTierDto'
        autoTopupNotificationsEnabled:
          type: boolean
          description: Master toggle for auto-topup outcome notifications.
          example: false
        autoTopupEmailEnabled:
          type: boolean
          description: Route auto-topup notifications via email.
          example: true
        autoTopupWebhookEnabled:
          type: boolean
          description: Route auto-topup notifications via webhook.
          example: true
      required:
        - lowBalanceEnabled
        - lowBalanceEmailEnabled
        - lowBalanceWebhookEnabled
        - lowBalanceTiers
        - globalHighUsageEnabled
        - globalHighUsageEmailEnabled
        - globalHighUsageWebhookEnabled
        - globalHighUsagePeriodMinutes
        - globalHighUsageTiers
        - highUsageEnabled
        - highUsageEmailEnabled
        - highUsageWebhookEnabled
        - highUsagePeriodMinutes
        - highUsageTiers
        - autoTopupNotificationsEnabled
        - autoTopupEmailEnabled
        - autoTopupWebhookEnabled
    BillingNotificationWorkspaceOverrideDto:
      type: object
      properties:
        id:
          type: string
          description: Override row ID.
          example: f2b5e0b8-1a3c-4f7e-9d2a-7c6b8a1d4e52
        workspaceId:
          type: string
          description: Workspace ID this override applies to.
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        createdAt:
          type: string
          description: Row creation timestamp.
          example: '2026-04-15T12:34:56.789Z'
          format: date-time
        updatedAt:
          type: string
          description: Row last-update timestamp.
          example: '2026-04-22T08:12:34.567Z'
          format: date-time
        highUsageEnabled:
          type: boolean
          description: Override for master high-usage toggle. Null means "inherit".
          example: true
          nullable: true
        highUsageEmailEnabled:
          type: boolean
          description: Override for email routing. Null means "inherit".
          example: true
          nullable: true
        highUsageWebhookEnabled:
          type: boolean
          description: Override for webhook routing. Null means "inherit".
          example: true
          nullable: true
        highUsagePeriodMinutes:
          type: number
          description: Override for rolling window minutes. Null means "inherit".
          example: 720
          nullable: true
        highUsageTiers:
          description: Override for tier thresholds. Null means "inherit".
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/HighUsageTierDto'
      required:
        - id
        - workspaceId
        - createdAt
        - updatedAt
    LowBalanceTierDto:
      type: object
      properties:
        tier:
          type: string
          description: Severity tier name. Must be unique within the array.
          enum:
            - warning
            - critical
            - depleted
          example: warning
        cents:
          type: number
          description: >-
            Threshold in cents (integer, same currency as the account). A
            notification fires when the account balance drops at or below this
            value.
          example: 100000
          minimum: 0
      required:
        - tier
        - cents
    HighUsageTierDto:
      type: object
      properties:
        tier:
          type: string
          description: Severity tier name. Must be unique within the array.
          enum:
            - warning
            - critical
          example: warning
        cents:
          type: number
          description: >-
            Spend threshold in cents over the rolling period. A notification
            fires when the rolling-period spend is at or above this value.
          example: 100000
          minimum: 0
      required:
        - tier
        - cents
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````