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

# Get your notification switches

> List every organization you belong to, the services it is licensed for, and your two switches for each: `email` (alert emails; `null` for a service that sends none, such as Virtual CISO) and `bell` (notifications under the bell). Every switch starts off. Incident deadlines, licence expiry and the daily API limit have no switch. These are the switches on Profile → Notifications. Reading them closes the “Choose what you hear about” notification.



## OpenAPI

````yaml get /api/v1/settings/notifications
openapi: 3.1.0
info:
  title: Aegister API
  version: 2.12.2
servers: []
security: []
paths:
  /api/v1/settings/notifications:
    get:
      tags:
        - Settings
      summary: Your notification switches
      description: >-
        Every organization you belong to, with the services it is licensed for
        and your email and bell switch for each. Every switch starts off.
        Incident deadlines, licence expiry and the daily API limit have no
        switch. Reading this closes the "Choose what you hear about" bell.
      operationId: settings_notifications_retrieve
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: integer
                    description: |-
                      Any value different from 0 indicates an error.  
                      More details can be found in `messages`.
                    minimum: 0
                    maximum: 0
                    examples:
                      - 0
                  messages:
                    type: array
                    description: >-
                      If `error` is `1`, contains zero or more details on the
                      error.
                    examples:
                      - []
                  total:
                    type: number
                    description: >-
                      Total number of items that meet the list filter.  

                      This doesn't represent the number of items inside the
                      `data` array.
                    minimum: 0
                    examples:
                      - 20
                      - 30
                      - 40
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        organization:
                          type: integer
                          description: Organization ID.
                        name:
                          type: string
                          description: Organization name.
                        logo:
                          type: string
                          nullable: true
                          description: Organization logo URL.
                        services:
                          type: array
                          description: >-
                            The services the organization is licensed for, each
                            with your two switches.
                          items:
                            type: object
                            properties:
                              area:
                                type: string
                                enum:
                                  - atb
                                  - cloud_defender
                                  - v_ciso
                                  - csirt_bulletins
                              email:
                                type: boolean
                                nullable: true
                                description: >-
                                  Alert emails. `null`: the service sends no
                                  mail.
                              bell:
                                type: boolean
                                description: Bell notifications.
          description: ''
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: integer
                    description: |-
                      Any value different from 0 indicates an error.  
                      More details can be found in `messages`.
                    minimum: 0
                    maximum: 0
                    examples:
                      - 1
                  messages:
                    type: array
                    description: >-
                      If `error` is `1`, contains zero or more details on the
                      error.
                    examples:
                      - []
          description: ''
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Aegister-Token

````

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