---
title: "Get notifications"
method: GET
path: "/api/notifications"
tags: ["Notifications"]
---

# Get notifications

`GET /api/notifications`

## Response `200`

OK

- ModelNotificationsResponse
  - `notifications` ModelNotification[]
    - `apiVersion` string
    - `kind` 'Configuration' | 'Agent' | 'AgentType' | 'AgentVersion' | 'Source' | 'Processor' | 'Connector' | 'Destination' | 'Extension' | 'SourceType' | 'ProcessorType' | 'ConnectorType' | 'DestinationType' | 'ExtensionType' | 'RecommendationType' | 'Unknown' | 'Rollout' | 'RolloutType' | 'Organization' | 'Account' | 'Invitation' | 'Login' | 'User' | 'AccountOrganizationBinding' | 'UserOrganizationBinding' | 'UserAccountBinding' | 'AuditTrail' | 'AvailableComponents' | 'SecretsManagerType' | 'SecretsManager' | 'Recording' | 'Credential' | 'CredentialType' | 'Fleet' | 'Integration' | 'IntegrationType' | 'ConfigurationType' | 'Notification' | 'Recommendation' | 'PublicProcessor' | 'Blueprint' | 'PrometheusRule' | 'APIKey' | 'ResourcePreset'
    - `metadata` ModelMetadata
      - `additionalInfo` ModelAdditionalInfo
        - `documentation` ModelDocumentationLink[]
          - `text` string
          - `url` string
        - `message` string
      - `blueprintTags` ModelBlueprintTags
      - `dateModified` string
      - `deprecated` boolean — Deprecated indicates that this resource is deprecated and should not be used. Deprecated resources should contain additional information about why the resource is deprecated and what should be used instead. Note: Ironically, the Deprecated field is itself deprecated. Use Stability instead.
      - `description` string
      - `displayName` string
      - `hash` string — Hash is a hex formatted sha256 Hash of the json-encoded spec that is used to determine if the spec has changed.
      - `icon` string
      - `id` string
      - `labels` ModelLabels
      - `name` string
      - `resourceDocLink` string
      - `stability` 'development' | 'alpha' | 'beta' | 'stable' | 'deprecated' | 'legacy' | ''
      - `version` integer — Version is a 1-based integer that is incremented each time the spec is changed.
      - `warning` string — Warning is an optional message that is displayed to the user when the resource is configured. Currently used for IntegrationTypes.
    - `spec` ModelNotificationSpec
      - `account` string
      - `adminOnly` boolean — AdminOnly, when true, hides this notification from non-admin viewers in an organization. Org-admin status is evaluated at the read path. Defaults to false for backwards compatibility.
      - `hidden` boolean
      - `notificationType` 'job' | 'pipeline_intelligence' | 'retool' | 'programmatic' | 'script'
      - `organization` string
      - `recommendationId` string
      - `scope` 'global' | 'account' | 'user' | 'organization'
      - `severity` string
      - `userId` string
    - `status` ModelNotificationStatusType
      - `userStatus` 'unread' | 'read' | 'dismissed' | 'accepted' | 'archived'

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.dev/bindplane/apis/docs-bindplane-com.md) · [All operations](https://skmtc.dev/bindplane/apis/docs-bindplane-com/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bindplane/docs-bindplane-com/revisions/bfcb7e57121c/schema)