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

# List alerts

> List the alerts on a resource type.



## OpenAPI

````yaml GET /api/v1/alerts
openapi: 3.0.3
info:
  title: Infisical API
  description: List of all available APIs that can be consumed
  version: 0.0.1
servers:
  - url: https://us.infisical.com
    description: Production server (US)
  - url: https://eu.infisical.com
    description: Production server (EU)
  - url: http://localhost:8080
    description: Local server
security: []
paths:
  /api/v1/alerts:
    get:
      tags:
        - Alerting
      description: List the alerts on a resource type.
      operationId: listAlerts
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 255
          in: query
          name: resourceType
          required: true
          description: The type of resource to list alerts for.
        - schema:
            type: string
            format: uuid
          in: query
          name: resourceId
          required: false
          description: >-
            The ID of the resource to list alerts for. If omitted, lists every
            alert on the resource type. For resource types that support alerts
            covering all of their resources, such as `cert-manager`, lists only
            those alerts.
        - schema:
            type: string
            format: uuid
          in: query
          name: projectId
          required: false
          description: The ID of the project to list alerts in.
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
          in: query
          name: enabled
          required: false
          description: Whether to list only enabled or only disabled alerts.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  alerts:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        name:
                          type: string
                        description:
                          type: string
                          nullable: true
                        resourceType:
                          type: string
                        resourceId:
                          type: string
                          nullable: true
                        eventType:
                          type: string
                        triggerType:
                          type: string
                        condition:
                          nullable: true
                        enabled:
                          type: boolean
                        orgId:
                          type: string
                        projectId:
                          type: string
                          nullable: true
                        resourceName:
                          type: string
                          nullable: true
                        filters:
                          type: object
                          additionalProperties:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                                  nullable: true
                              required:
                                - id
                                - name
                              additionalProperties: false
                          description: >-
                            The resources named in the alert's condition, such
                            as applications, certificate profiles, and signers,
                            each as `{ id, name }`. `name` is null for a deleted
                            resource.
                        channels:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                              name:
                                type: string
                              channelType:
                                type: string
                              enabled:
                                type: boolean
                              config:
                                type: object
                                additionalProperties: {}
                              recipients:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    principalType:
                                      type: string
                                    principalId:
                                      type: string
                                  required:
                                    - principalType
                                    - principalId
                                  additionalProperties: false
                            required:
                              - id
                              - name
                              - channelType
                              - enabled
                              - config
                              - recipients
                            additionalProperties: false
                        lastRun:
                          type: object
                          properties:
                            timestamp:
                              type: string
                              format: date-time
                            status:
                              type: string
                              enum:
                                - success
                                - partial
                                - failed
                          required:
                            - timestamp
                            - status
                          additionalProperties: false
                          nullable: true
                        createdAt:
                          type: string
                          format: date-time
                        updatedAt:
                          type: string
                          format: date-time
                      required:
                        - id
                        - name
                        - description
                        - resourceType
                        - resourceId
                        - eventType
                        - triggerType
                        - enabled
                        - orgId
                        - projectId
                        - channels
                        - createdAt
                        - updatedAt
                      additionalProperties: false
                required:
                  - alerts
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reqId:
                    type: string
                  statusCode:
                    type: number
                    enum:
                      - 400
                  message:
                    type: string
                  error:
                    type: string
                  details: {}
                required:
                  - reqId
                  - statusCode
                  - message
                  - error
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reqId:
                    type: string
                  statusCode:
                    type: number
                    enum:
                      - 401
                  message:
                    type: string
                  error:
                    type: string
                required:
                  - reqId
                  - statusCode
                  - message
                  - error
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reqId:
                    type: string
                  statusCode:
                    type: number
                    enum:
                      - 403
                  message:
                    type: string
                  details: {}
                  error:
                    type: string
                required:
                  - reqId
                  - statusCode
                  - message
                  - error
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reqId:
                    type: string
                  statusCode:
                    type: number
                    enum:
                      - 404
                  message:
                    type: string
                  error:
                    type: string
                required:
                  - reqId
                  - statusCode
                  - message
                  - error
                additionalProperties: false
        '422':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reqId:
                    type: string
                  statusCode:
                    type: number
                    enum:
                      - 422
                  message: {}
                  error:
                    type: string
                required:
                  - reqId
                  - statusCode
                  - error
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  reqId:
                    type: string
                  statusCode:
                    type: number
                    enum:
                      - 500
                  message:
                    type: string
                  error:
                    type: string
                required:
                  - reqId
                  - statusCode
                  - message
                  - error
                additionalProperties: false

````

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