Skip to main content
GET
/
bugs
curl -X GET "https://nunu.ai/api/v1/bugs?status=active&severity=high&page=0&page_size=20" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "data": [
    {
      "id": "bug_8a1b2c3d",
      "project_id": "test",
      "title": "Inventory icon flickers when opening menu",
      "description": "When the inventory menu is opened quickly after a level transition, the inventory icon briefly flickers in and out.",
      "reproduction_steps": "1. Complete a level. 2. Press the inventory button immediately after the transition.",
      "severity": "medium",
      "category": "ui",
      "confidence": "high",
      "tags": ["ui", "menu"],
      "details": null,
      "status": "active",
      "suppress_reporting": false,
      "occurrence_count": 4,
      "created_at": "2026-04-01T10:00:00.000000+00:00",
      "created_by": "reviewer@example.com"
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 20,
    "total_count": 1,
    "total_pages": 1
  }
}

Documentation Index

Fetch the complete documentation index at: https://api-docs.nunu.ai/llms.txt

Use this file to discover all available pages before exploring further.

Permission Required: project:read-runs
Retrieve a paginated list of reviewed bugs for your project. This endpoint returns the project-wide bug review feed (bugs that have been reviewed and tracked across runs). To list bugs detected during a single run, use List Run Bugs instead.
Returns 403 if the project does not have the bug_review feature enabled.

​
Query Parameters

​
status
string
default:"active"
Filter by status: active, archived, or all
​
search
string
Free-text search across bug title, description, and reproduction steps
​
severity
string
Filter by severity: low, medium, high, or critical
​
category
string
Filter by bug category (e.g., ui, gameplay, performance)
​
sort_by
string
Field to sort by (e.g., created_at, severity, occurrence_count)
​
sort_order
string
Sort direction: asc or desc
​
page
integer
default:"0"
Page number (0-indexed)
​
page_size
integer
default:"20"
Results per page (1-100)

​
Response

​
data
BugSummary[]
required
Array of bug summary objects
​
pagination
object
required
Pagination metadata (page, page_size, total_count, total_pages)

​
BugSummary Object

​
id
string
required
Unique bug identifier (consistent across runs)
​
project_id
string
required
Project the bug belongs to
​
title
string
required
Short bug title
​
description
string
required
Detailed description of the bug
​
reproduction_steps
string
required
Steps to reproduce the bug
​
severity
string
required
Severity level: low, medium, high, critical
​
category
string
required
Bug category (e.g., ui, gameplay, performance)
​
confidence
string
required
Detection confidence: low, medium, high
​
tags
string[]
required
Tags assigned to the bug
​
details
object
Additional bug-specific metadata, or null
​
status
string
required
Bug status: active or archived
​
suppress_reporting
boolean
required
Whether reporting for this bug is suppressed
​
occurrence_count
integer
required
Number of times this bug has been observed across runs
​
created_at
string
required
ISO 8601 timestamp when the bug was first reviewed
​
created_by
string
Who created/reviewed the bug
curl -X GET "https://nunu.ai/api/v1/bugs?status=active&severity=high&page=0&page_size=20" \
  -H "X-Api-Key: YOUR_API_TOKEN"

{
  "data": [
    {
      "id": "bug_8a1b2c3d",
      "project_id": "test",
      "title": "Inventory icon flickers when opening menu",
      "description": "When the inventory menu is opened quickly after a level transition, the inventory icon briefly flickers in and out.",
      "reproduction_steps": "1. Complete a level. 2. Press the inventory button immediately after the transition.",
      "severity": "medium",
      "category": "ui",
      "confidence": "high",
      "tags": ["ui", "menu"],
      "details": null,
      "status": "active",
      "suppress_reporting": false,
      "occurrence_count": 4,
      "created_at": "2026-04-01T10:00:00.000000+00:00",
      "created_by": "reviewer@example.com"
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 20,
    "total_count": 1,
    "total_pages": 1
  }
}

Authorizations

​
X-Api-Key
string
header
required

API key for authentication

Query Parameters

​
status
enum<string>
default:active

Filter by status

Available options:
active,
archived,
all
​
search
string

Free-text search across title/description/reproduction steps

​
severity
enum<string>

Filter by severity

Available options:
low,
medium,
high,
critical
​
category
string

Filter by bug category

​
sort_by
string

Field to sort by

​
sort_order
enum<string>

Sort direction

Available options:
asc,
desc
​
page
integer
default:0

Page number (0-indexed)

​
page_size
integer
default:20

Results per page (1-100)

Required range: 1 <= x <= 100

Response

Successful response

​
data
object[]
​
pagination
object