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

# Export vulnerabilities as SARIF

> The vulnerabilities matching the list filters as a SARIF 2.1.0 log, one run per repository, ready for GitHub code scanning. Fixed findings are left out, so uploading the log closes their alerts. Rather than truncate, the request fails with `export_too_large` when the filters match more than 10,000 vulnerabilities.



## OpenAPI

````yaml /api-reference/openapi.json get /vulnerabilities/sarif
openapi: 3.1.0
info:
  title: Gecko Security API
  version: 1.5.0
  description: >-
    Programmatic access to scans, vulnerabilities, repositories, schedules,
    integrations, and scanner image releases. Authenticate with an API key via
    the `X-API-Key` header or `Authorization: Bearer <key>`.
servers:
  - url: https://app.gecko.security/api/v1
security:
  - ApiKeyHeader: []
  - BearerAuth: []
paths:
  /vulnerabilities/sarif:
    get:
      summary: Export vulnerabilities as SARIF
      description: >-
        The vulnerabilities matching the list filters as a SARIF 2.1.0 log, one
        run per repository, ready for GitHub code scanning. Fixed findings are
        left out, so uploading the log closes their alerts. Rather than
        truncate, the request fails with `export_too_large` when the filters
        match more than 10,000 vulnerabilities.
      parameters:
        - name: severity
          in: query
          schema:
            type: string
        - name: status
          in: query
          schema:
            type: string
        - name: type
          in: query
          schema:
            type: string
        - name: cwe
          in: query
          schema:
            type: string
          description: Comma-separated CWE ids; `CWE-79`, `cwe-79` and `79` are equivalent.
        - name: created_after
          in: query
          schema:
            type: string
            format: date-time
        - name: created_before
          in: query
          schema:
            type: string
            format: date-time
        - name: repository
          in: query
          schema:
            type: string
        - name: scan_id
          in: query
          schema:
            type: string
            format: uuid
        - name: pull_request
          in: query
          schema:
            type: integer
            minimum: 1
          description: >-
            Filter to the PR/MR with this number; combine with `repository` to
            disambiguate across repos.
      responses:
        '200':
          description: A SARIF 2.1.0 log
          content:
            application/sarif+json: {}
        '400':
          description: Invalid filters, or too many matches
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Authentication error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Authorization error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
            code:
              type: string
            message:
              type: string
            param:
              type: string
            doc_url:
              type: string
            request_id:
              type: string
          required:
            - type
            - code
            - message
            - doc_url
            - request_id
      required:
        - error
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    BearerAuth:
      type: http
      scheme: bearer

````

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