> ## 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.

# List an organization's CSIRT bulletins

> Read what the CSIRT bulletins page shows: CSIRT Italia's vulnerability bulletins checked against the organization's V-CISO hardware and software inventories. You get the two inventories (with `stale` after six months), the bulletins about your systems nobody opened yet (`attention`), your systems with the bulletins that name each, and one page of every bulletin since a year before the licence started, filtered and sorted with the query parameters. Texts come in the language of the request. The organization needs the CSIRT bulletins and V-CISO licences: `missing` names the ones it lacks, and then the rest is empty. Every member can read it.



## OpenAPI

````yaml get /api/v1/v-ciso/organizations/{organizationid}/csirt-bulletins
openapi: 3.1.0
info:
  title: Aegister API
  version: 2.12.2
servers: []
security: []
paths:
  /api/v1/v-ciso/organizations/{organizationid}/csirt-bulletins:
    get:
      tags:
        - CSIRT bulletins
      summary: The organization's CSIRT bulletins
      description: >-
        The two inventories the bulletins are checked against (systems, last
        change, `stale` after six months), the bulletins that hit your systems
        nobody opened yet (`attention`), your systems with the bulletins that
        hit each, and one page of every bulletin since 12 months before the
        licence, in the reader's language. A bulletin with no match may still
        concern you when the product is not in your inventory. `missing` names
        the licences the organization lacks (csirt_bulletins, v_ciso); with any
        missing the rest is empty.
      operationId: v-ciso-csirt-bulletins
      parameters:
        - in: query
          name: category
          schema:
            type: string
          description: Kind of product, e.g. firewall_network.
        - in: query
          name: date_from
          schema:
            type: string
          description: Published on or after this day (ISO date, in `tz`).
        - in: query
          name: date_to
          schema:
            type: string
          description: Published on or before this day (ISO date, in `tz`).
        - in: query
          name: opened
          schema:
            type: string
            enum:
              - 'no'
              - 'yes'
        - in: query
          name: order
          schema:
            type: string
            enum:
              - '-opened'
              - '-published'
              - '-severity'
              - '-title'
              - '-yours'
              - opened
              - published
              - severity
              - title
              - yours
          description: The sort; `-` first = descending. Newest first by default.
        - in: path
          name: organizationid
          schema:
            type: integer
          required: true
        - in: query
          name: page
          schema:
            type: integer
        - in: query
          name: page_size
          schema:
            type: integer
        - in: query
          name: q
          schema:
            type: string
        - in: query
          name: scope
          schema:
            type: string
            enum:
              - all
              - exploited
              - yours
        - in: query
          name: severity
          schema:
            type: string
            enum:
              - alta
              - bassa
              - critica
              - media
              - unknown
        - in: query
          name: system
          schema:
            type: string
          description: >-
            Only the bulletins that hit this system: its asset id, or its name
            when it has none.
        - in: query
          name: tz
          schema:
            type: string
          description: The time zone the days are read in, e.g. Europe/Rome (default UTC).
      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:
                      - []
                  data:
                    type: object
                    properties:
                      missing:
                        type: array
                        items:
                          type: string
                      state:
                        type: object
                        nullable: true
                      inventories:
                        type: array
                        items:
                          type: object
                      attention:
                        type: array
                        items:
                          type: object
                      matched:
                        type: array
                        items:
                          type: object
                      systems:
                        type: array
                        items:
                          type: object
                      counts:
                        type: object
                      facets:
                        type: object
                      scopes:
                        type: object
                      bulletins:
                        type: array
                        items:
                          type: object
                      total:
                        type: integer
                      page:
                        type: integer
                      page_size:
                        type: integer
          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: ''
        '404':
          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.