> ## 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.

# List recent billing notification events



## OpenAPI

````yaml get /v2/billing/notifications/recent
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/recent:
    get:
      tags:
        - Billing Notifications
      summary: List recent billing notification events
      operationId: BillingNotificationsController_listRecent_v2
      parameters:
        - name: limit
          required: false
          in: query
          description: Max events to return (1–200, default 50).
          schema:
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BillingNotificationEventDto'
      security:
        - x-api-key: []
components:
  schemas:
    BillingNotificationEventDto:
      type: object
      properties:
        id:
          type: string
          description: Event ID.
          example: e8f4c2a1-3b7d-4e9f-8a1c-6b5d3e2a9f01
        kind:
          type: string
          description: Notification kind.
          enum:
            - low_balance
            - high_usage
            - auto_topup
          example: low_balance
        identifier:
          type: string
          description: >-
            Tier name (`warning` / `critical` / `depleted`) for low_balance and
            high_usage, or outcome (`succeeded` / `failed`) for auto_topup.
          example: warning
        accountId:
          type: string
          description: Account the event belongs to.
          example: acc_01H8XYZ...
        workspaceId:
          type: string
          description: Workspace the event was scoped to, or null for account-level events.
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
          nullable: true
        dedupKey:
          type: string
          description: Dedup key used to enforce one-fire-per-threshold-per-period.
          example: low_balance:warning:acc_01H8XYZ:2026-04-22
        firedAt:
          type: string
          description: When the event fired.
          example: '2026-04-22T08:12:34.567Z'
          format: date-time
        payload:
          type: object
          description: >-
            Kind-specific payload (threshold cents, period info, auto-topup
            details, etc.).
          additionalProperties: true
          example:
            tierCents: 100000
            balanceCents: 85000
        emailSent:
          type: boolean
          description: Whether an email was dispatched.
          example: true
        webhookSent:
          type: boolean
          description: Whether a webhook was dispatched.
          example: true
      required:
        - id
        - kind
        - identifier
        - accountId
        - dedupKey
        - firedAt
        - payload
        - emailSent
        - webhookSent
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````