---
title: "List issues"
method: GET
path: "/issues"
tags: ["Issues"]
---

# List issues

`GET /issues`

## Request

- Base URL: `https://api.marboba.com/v1`
- URL: `https://api.marboba.com/v1/issues`
- Auth: HTTP bearer

Returns issues newest-first. Supports filtering by `appId`, `status`, `severity`, `issueType`, `assignedToUid` query params (any combination).

## Query parameters

- `appId` string
- `status` string
- `severity` string
- `issueType` string
- `assignedToUid` string

## Response `200`

Issues in the calling token's org matching the filters

- object
  - `issues` Issue[]
    - `id` string, required
    - `sequenceNumber` integer, nullable: Org-wide sequential issue number assigned by a Firestore trigger after create. May be null on docs that were just created.
    - `appId` string, required: Owning project (component) id.
    - `title` string, required
    - `description` string
    - `severity` 'minor' | 'major' | 'critical' | 'blocker', required
    - `status` 'newBug' | 'triaged' | 'inProgress' | 'blocked' | 'fixed' | 'verified' | 'wontFix' | 'duplicate', required
    - `statusGroup` 'backlog' | 'active' | 'done' | 'closed', required: Denormalized board column derived server-side from `status`. Read-only — set `status` and the server picks the right group.
    - `issueType` 'bug' | 'enhancement' | 'feature' | 'task', required
    - `assignedToUid` string, nullable
    - `labels` string[], required
    - `dueDate` string, date-time, nullable
    - `startDate` string, date-time, nullable
    - `estimateMinutes` integer, nullable
    - `githubIssueNumber` integer, nullable
    - `githubIssueUrl` string, nullable
    - `jiraIssueKey` string, nullable
    - `jiraIssueUrl` string, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable
    - `version` integer, required: Optimistic-concurrency counter, increments on every successful update.

## Other responses

- `401` (unresolved $ref)

---

[API](https://skmtc.dev/marboba/apis/marboba-public-rest-api.md) · [All operations](https://skmtc.dev/marboba/apis/marboba-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marboba/apis/marboba-public-rest-api/revisions/5b96d525d88d?raw)
