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

# Get notification subscriptions

> Retrieve the authenticated user's notification configuration, available channels, current selections, and user context. The `{user}` path accepts the authenticated user's numeric ID or `me`.



## OpenAPI

````yaml /developers/api-reference/openapi.json get /notifications/{user}/subscriptions
openapi: 3.0.0
info:
  description: >-
    The BeatPass API provides access to platform data for approved developer
    integrations. API access is invite-only — contact contact@beatpass.ca to
    request access. Authenticate with a Bearer token. Tokens expire after 90
    days. Unauthenticated requests return minimal data (e.g. id, name, image,
    model_type, and basic metadata). Global rate limit: 300 requests/minute.
  version: 1.0.1
  title: BeatPass API
servers:
  - url: https://open.beatpass.ca/api/v1
    description: Production API
security:
  - bearerAuth: []
tags:
  - name: Search
    description: Search across albums, artists, playlists, tracks and users
  - name: Playlists
    description: Manage playlists and playlist tracks
  - name: Playlist Collaboration
    description: Invite users to collaborate on playlists
  - name: Artists
    description: Manage artists and artist information
  - name: Albums
    description: Manage albums and album information
  - name: Tracks
    description: Manage tracks, downloads and track information
  - name: Track Purchases
    description: Purchase tracks and generate exclusive licenses
  - name: License Certificates
    description: Generate, verify and manage track licenses
  - name: Audio Fingerprinting
    description: Generate audio fingerprints and detect duplicates
  - name: Beat Requests
    description: Create and manage custom beat requests
  - name: Producer Intelligence
    description: Analytics, XP, achievements and leaderboards for producers
  - name: Tags
    description: Manage track and album tags
  - name: Genres
    description: Manage music genres
  - name: Users
    description: User management, search and social features
  - name: User Library
    description: Manage user's liked tracks, albums and artists
  - name: Reposts
    description: Repost tracks to share with followers
  - name: Track Plays
    description: Log and track music playback statistics
  - name: Radio
    description: Get personalized music recommendations
  - name: Leaderboards
    description: Platform-wide producer and achievement leaderboards
  - name: Cover Art
    description: Generate custom cover art using templates
  - name: Auth
    description: Authenticate requests to the API
  - name: Messaging
    description: Direct messages, group conversations, and real-time features
  - name: Collections
    description: Curated content collections
  - name: Stripe Connect
    description: Legacy Stripe Connect onboarding and financial overview where available
  - name: Exclusive Licenses
    description: Manage exclusive license pricing presets
  - name: Coupons
    description: Validate discount codes during checkout
  - name: Notifications
    description: Manage notification preferences and FCM device tokens
paths:
  /notifications/{user}/subscriptions:
    get:
      tags:
        - Notifications
      summary: Get notification subscriptions
      description: >-
        Retrieve the authenticated user's notification configuration, available
        channels, current selections, and user context. The `{user}` path
        accepts the authenticated user's numeric ID or `me`.
      operationId: getNotificationSubscriptions
      parameters:
        - name: user
          in: path
          required: true
          schema:
            type: string
            example: me
          description: Authenticated user ID or `me`.
      responses:
        '200':
          description: Notification configuration and current selections
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  available_channels:
                    type: array
                    items:
                      type: string
                    example:
                      - email
                      - in_app
                      - mobile
                  subscriptions:
                    type: array
                    description: >-
                      Notification preference groups and available notification
                      types.
                    items:
                      type: object
                      properties:
                        group_name:
                          type: string
                          example: Messages
                        group_description:
                          type: string
                          nullable: true
                          example: Notifications about direct activity
                        requires:
                          type: string
                          nullable: true
                          enum:
                            - artist
                            - verified_artist
                        subscriptions:
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                                example: Direct Messages
                              notif_id:
                                type: string
                                example: new_message
                              description:
                                type: string
                                example: When you receive a direct message
                              requires:
                                type: string
                                nullable: true
                                enum:
                                  - artist
                                  - verified_artist
                  user_selections:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          nullable: true
                          example: 1
                        name:
                          type: string
                          example: Direct Messages
                        notif_id:
                          type: string
                          example: new_message
                        description:
                          type: string
                          nullable: true
                          example: When you receive a direct message
                        requires:
                          type: string
                          nullable: true
                          enum:
                            - artist
                            - verified_artist
                        channels:
                          type: object
                          additionalProperties:
                            type: boolean
                          example:
                            email: true
                            in_app: true
                            mobile: true
                  user_context:
                    type: object
                    properties:
                      is_artist:
                        type: boolean
                      is_verified_artist:
                        type: boolean
        '401':
          $ref: '#/components/responses/Response401'
        '404':
          $ref: '#/components/responses/Response404'
components:
  responses:
    Response401:
      description: Unauthenticated. Bearer token is missing, invalid, or expired.
    Response404:
      description: Resource not found. Could not find a resource with specified name or ID.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API access is invite-only. Contact contact@beatpass.ca to request
        access. Once approved, generate tokens from Account Settings →
        Developers. Include as: Authorization: Bearer {token}. Tokens expire
        after 90 days.

````