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

# List issues

> Lists issues QA.tech has found in the project, deduplicated across the runs where they recur and sorted by most recent occurrence (newest first). Defaults to `ACTIVE` issues; filter by `severity`, `status`, or a `since`/`until` window. Each issue includes its severity, status, type, a help URL, timestamps, and a deep link. Pass a returned `shortId` to `get_issue` for the run test cases that triggered it.



## OpenAPI

````yaml /api-reference/api.json get /v1/issues
openapi: 3.0.0
info:
  title: QA.tech API
  version: 1.0.0
  contact:
    name: QA.tech
    url: https://qa.tech
    email: support@qa.tech
  description: API for triggering and managing AI-powered test runs
servers:
  - url: https://api.qa.tech
    description: Production
    variables: {}
security:
  - BearerAuth: []
tags:
  - name: Runs
  - name: Infrastructure
  - name: Test Cases
  - name: Application Builds
  - name: Status badge
  - name: Remote Tunnels
  - name: Chat
  - name: Applications
  - name: Features
  - name: Metrics
  - name: Release Checks
  - name: Projects
  - name: Knowledge
  - name: Rules
  - name: Issues
paths:
  /v1/issues:
    get:
      tags:
        - Issues
      summary: List issues
      description: >-
        Lists issues QA.tech has found in the project, deduplicated across the
        runs where they recur and sorted by most recent occurrence (newest
        first). Defaults to `ACTIVE` issues; filter by `severity`, `status`, or
        a `since`/`until` window. Each issue includes its severity, status,
        type, a help URL, timestamps, and a deep link. Pass a returned `shortId`
        to `get_issue` for the run test cases that triggered it.
      operationId: ListIssues
      parameters:
        - name: query
          in: query
          required: true
          schema:
            $ref: '#/components/schemas/ListIssuesQuery'
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListIssuesResponse'
components:
  schemas:
    ListIssuesQuery:
      type: object
      properties:
        severity:
          type: string
          enum:
            - MINOR
            - MAJOR
            - CRITICAL
          description: Filter to issues of this severity. Omitted returns every severity.
        status:
          type: string
          enum:
            - ACTIVE
            - IGNORED
            - all
          description: >-
            Filter by issue status. Defaults to `ACTIVE` (open issues that still
            need attention). Pass `IGNORED` for dismissed issues, or `all` to
            include both.
          default: ACTIVE
        since:
          allOf:
            - $ref: '#/components/schemas/Iso8601Timestamp'
          description: Only include issues last seen at or after this ISO 8601 timestamp.
        until:
          allOf:
            - $ref: '#/components/schemas/Iso8601Timestamp'
          description: Only include issues last seen at or before this ISO 8601 timestamp.
        orderDirection:
          type: string
          enum:
            - asc
            - desc
          description: >-
            Sort direction by most recent occurrence. Defaults to `desc` (newest
            first).
          default: desc
        limit:
          type: integer
          format: int32
          minimum: 1
          maximum: 100
          description: Maximum number of issues to return (1-100). Defaults to 20.
          default: 20
        offset:
          type: integer
          format: int32
          minimum: 0
          description: Number of issues to skip for pagination. Defaults to 0.
        projectShortId:
          allOf:
            - $ref: '#/components/schemas/ProjectShortId'
          description: >-
            Target a specific project by its prefixed short ID
            (proj-slug_shortId or proj_shortId), as returned by the projects
            API. Required for organization-scoped API keys; project-scoped keys
            may only pass their own project's short ID.
      description: >-
        Filters for listing issues QA.tech has found in a project. Every filter
        is optional; with no filters the most recently seen `ACTIVE` issues are
        returned, newest first.
    ListIssuesResponse:
      type: object
      required:
        - issues
        - total
        - limit
        - offset
      properties:
        issues:
          type: array
          items:
            $ref: '#/components/schemas/IssueListItem'
        total:
          type: integer
          format: int32
        limit:
          type: integer
          format: int32
        offset:
          type: integer
          format: int32
      description: Issues found in the project, newest first, with pagination.
    Iso8601Timestamp:
      type: string
      pattern: >-
        ^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])([Tt
        ]([01]\d|2[0-3]):[0-5]\d(:[0-5]\d)?(\.\d+)?([Zz]|[+-]([01]\d|2[0-3]):?[0-5]\d)?)?$
    ProjectShortId:
      type: string
      pattern: ^proj(-.+_.+|_.+)$
    IssueListItem:
      type: object
      required:
        - shortId
        - title
        - description
        - severity
        - status
        - issueType
        - helpUrl
        - createdAt
        - lastOccurredAt
        - url
      properties:
        shortId:
          type: string
          description: >-
            Stable short ID. Pass to `get_issue` for full detail, or open `url`
            in the dashboard.
        title:
          type: string
        description:
          type: string
          nullable: true
        severity:
          type: string
          description: >-
            `MINOR`, `MAJOR`, or `CRITICAL`. Higher severity sorts first when
            occurrence times tie.
        status:
          type: string
          description: '`ACTIVE` or `IGNORED`.'
        issueType:
          type: string
          description: >-
            The category of the issue, e.g. `ACCESSIBILITY`, `CONSOLE`,
            `HOSTING`, or `FAILED_TEST`.
        helpUrl:
          type: string
          nullable: true
          description: Link to remediation guidance for the issue, when available.
        createdAt:
          type: string
          description: When the issue was first detected.
        lastOccurredAt:
          type: string
          nullable: true
          description: >-
            When the issue was most recently detected. `null` if it has not been
            recomputed since creation.
        url:
          type: string
          description: Deep link to the issue in the QA.tech dashboard.
      description: >-
        An issue QA.tech has found in the project, deduplicated across the runs
        where it recurs.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: Bearer

````