---
title: "List bug reports"
method: GET
path: "/v1/bug-reports"
tags: ["bug-reports"]
---

# List bug reports

`GET /v1/bug-reports`

## Request

- Base URL: `https://api.qualgent.ai`
- URL: `https://api.qualgent.ai/v1/bug-reports`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/qualgent/apis/qualgent-api-service/docs/v1/bug-reports/get.ts> (a function with typed inputs; its response is checked against the schema)

Return your organization's bug reports, most severe first and newest first
    within a severity. Pass `app_file_id` to get the bug reports for one build.

    A bug found by QualGent appears here once QualGent has reviewed it, which is also
    when it appears in `bugs` on `GET /v1/missions/submissions`. Deleted bugs are not returned.

    **Query parameters:**
    - `app_file_id`: return only bug reports for this app build
    - `status`: `open`, `in_progress`, `fixed` or `wont_fix`
    - `severity`: `low`, `medium`, `high` or `critical`
    - `failure_classification`: `app_bug` or `setup_issue`
    - `limit` and `offset`: page through the result

    **Each bug report includes:**
    - `id` and `bugId`, the human-readable ID such as `BUG_014`
    - `summary`, `steps` (one step per line) and `resultDetails` with `expected` and `actual`
    - `status`, `severity` and `failureClassification`
    - `appFileId` and `appFile`: the build the bug was found on
    - `attachment`: the screenshot or recording, with a `downloadUrl` valid for one hour
    - `externalTicket`: the linked GitHub, Jira or Linear ticket
    - `createdAt` and `updatedAt`

## Query parameters

- `app_file_id` string, uuid, nullable: Return only bug reports for this app build
- `status` 'open' | 'in_progress' | 'fixed' | 'wont_fix', nullable: Filter by status
- `severity` 'low' | 'medium' | 'high' | 'critical', nullable: Filter by severity
- `failure_classification` 'app_bug' | 'setup_issue', nullable: Filter by failure classification ('app_bug' or 'setup_issue')
- `limit` integer: Maximum number of bug reports to return
- `offset` integer: Number of bug reports to skip

## Headers

- `x-api-key` string

## Response `200`

Bug reports retrieved

- object

## Other responses

- `401`: Invalid or missing API key
- `422`: A query parameter is not valid

## Changes

- **2026-10-07** `659dfde2d76c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qualgent/apis/qualgent-api-service/changes/v1/bug-reports/get.md)

---

[API](https://skmtc.dev/qualgent/apis/qualgent-api-service.md) - [All operations](https://skmtc.dev/qualgent/apis/qualgent-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/qualgent/apis/qualgent-api-service/revisions/e04a6e95240e?raw)