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

# Get vendor alert settings

> Retrieves the alert settings in effect for your organization, one set for each
alert category, including security incidents. Categories and settings you haven’t
configured use their defaults. Requires continuous monitoring.



## OpenAPI

````yaml /reference/manage-vanta.json get /vendor-alert-settings
openapi: 3.0.0
info:
  title: Manage Vanta
  version: 1.0.0
  description: >-
    The REST API lets customers query and mutate Vanta's data. Use this API to
    automate bulk actions, query data for custom workflows and dashboards, and
    bolster your security operations


    **Note for Vanta Gov (FedRAMP) customers:** Select `Vanta Gov (FedRAMP)`
    from the server dropdown to issue requests against
    `https://api.vanta-gov.com`. The OAuth token URL shown below defaults to the
    commercial host — replace it with `https://api.vanta-gov.com/oauth/token`.
  termsOfService: https://www.vanta.com/terms
  license:
    name: UNLICENSED
  contact:
    name: API Support
    url: https://help.vanta.com/
    email: support@vanta.com
servers:
  - url: https://api.vanta.com/v1
    description: Vanta (Commercial)
  - url: https://api.vanta-gov.com/v1
    description: Vanta Gov (FedRAMP)
security: []
paths:
  /vendor-alert-settings:
    get:
      tags:
        - Vendor Alert Settings
      summary: Get vendor alert settings
      description: >-
        Retrieves the alert settings in effect for your organization, one set
        for each

        alert category, including security incidents. Categories and settings
        you haven’t

        configured use their defaults. Requires continuous monitoring.
      operationId: GetVendorAlertSettings
      parameters: []
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VendorAlertSettingsResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    VendorAlertSettingsResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/VendorAlertSettingsItem'
          type: array
          description: >-
            Effective organization-wide settings, including defaults for missing
            categories.
      required:
        - items
      type: object
      additionalProperties: false
    VendorAlertSettingsItem:
      properties:
        category:
          $ref: '#/components/schemas/VendorAlertSettingsCategoryName'
          description: Alert category.
        isEnabled:
          type: boolean
          description: Whether alerts in this category are enabled.
        riskLevelSetting:
          $ref: '#/components/schemas/VendorAlertRiskLevelSetting'
          description: >-
            Vendor inherent-risk levels that produce alerts. ANY includes
            unscored vendors.
        severitySetting:
          $ref: '#/components/schemas/VendorAlertSeveritySetting'
          description: Alert severities to include. ANY includes all severities.
      required:
        - category
        - isEnabled
        - riskLevelSetting
        - severitySetting
      type: object
      additionalProperties: false
    VendorAlertSettingsCategoryName:
      type: string
      enum:
        - Application security
        - Exposed application user interfaces
        - Exposed services
        - Exposed & leaked sensitive information
        - End of life & outdated applications
        - Sensitive interfaces exposure
        - Threat intelligence
        - Trust
        - Vulnerabilities
        - Vulnerable misconfigurations
        - Security incidents
    VendorAlertRiskLevelSetting:
      type: string
      enum:
        - ANY
        - LOW_MEDIUM_HIGH_CRITICAL
        - MEDIUM_HIGH_CRITICAL
        - HIGH_CRITICAL
        - CRITICAL
    VendorAlertSeveritySetting:
      type: string
      enum:
        - ANY
        - MEDIUM_HIGH_CRITICAL
        - HIGH_CRITICAL
        - CRITICAL
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

## Related topics

- [Update vendor alert settings](https://developer.vanta.com/api-reference/vendor-alert-settings/update-vendor-alert-settings.md)
- [Get vendor alert](https://developer.vanta.com/api-reference/vendor-alerts/get-vendor-alert.md)
- [Get vendor security incident alert by ID](https://developer.vanta.com/api-reference/vendor-security-incident-alerts/get-vendor-security-incident-alert-by-id.md)
- [List vendor alerts](https://developer.vanta.com/api-reference/vendor-alerts/list-vendor-alerts.md)
- [Update vendor alerts](https://developer.vanta.com/api-reference/vendor-alerts/update-vendor-alerts.md)