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

# Get Alert Topics

> Retrieve available alert topics organized by application with subscription status for granular notification control



## OpenAPI

````yaml /openapi/alerts.json get /v2/topics
openapi: 3.1.0
info:
  title: Dialect Alerts V2 API
  description: >-
    Notification infrastructure for real-time alert delivery through multiple
    channels including in-app notifications, email, push notifications, and
    Telegram.
  version: 2.2.0-beta
servers:
  - url: https://alerts-api.dial.to
    description: Dialect Production
  - url: https://alerts.dialectapi.to
    description: Dialect Production
security: []
paths:
  /v2/topics:
    get:
      tags:
        - Integrate an Inbox
      summary: Get Alert Topics
      description: >-
        Retrieve available alert topics organized by application with
        subscription status for granular notification control
      operationId: getAlertTopics
      parameters:
        - name: appId
          in: query
          schema:
            type: string
            format: uuid
            description: Application ID
            example: 255d6163-7e25-43e9-a188-c2f8d0980a4a
        - name: X-Dialect-Client-Key
          in: header
          required: true
          schema:
            type: string
            description: Client Key used to uniquely identify the client
            example: dk_gyh2eqzfkc4mhp5eiahnndkz
      responses:
        '200':
          description: Alert topics retrieved with subscription status
          content:
            application/json:
              schema:
                type: object
                properties:
                  byApp:
                    type: object
                    propertyNames:
                      type: string
                      format: uuid
                      description: App ID
                    additionalProperties:
                      type: object
                      properties:
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                description: Unique identifier for the topic
                                example: 123e4567-e89b-12d3-a456-426614174000
                              name:
                                type: string
                                description: Name of the topic
                                example: Price Alerts
                              description:
                                type: string
                                description: Description of the topic
                                example: >-
                                  Receive alerts when prices drop below a
                                  certain threshold
                              slug:
                                type: string
                                description: Human-readable slug of the topic
                                example: price-alerts
                              subscribed:
                                type: boolean
                                description: >-
                                  Whether the subscriber has enabled
                                  notifications for this topic
                                example: true
                            required:
                              - id
                              - name
                              - slug
                              - subscribed
                      required:
                        - items
                required:
                  - byApp
        '400':
          description: Request validation error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                required:
                  - error
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
        - subscriber: []
components:
  securitySchemes:
    subscriber:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Bearer token authentication for subscriber calls

````