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

# List issues

`GET /api/v1/issues`

## Request

- Base URL: `https://api.capy.ai`
- URL: `https://api.capy.ai/api/v1/issues`
- Auth: HTTP bearer

## Query parameters

- `projectId` string
- `status` 'open' | 'closed' | 'all': Open (the default), closed, or all. `stateIds` narrows further.
- `stateIds` union
  - string
  - string[]
- `priorities` union
  - 'urgent' | 'high' | 'normal' | 'low'
  - string[]
- `assignee` string: The assignee: a user id, a thread id, `me` for the key's own user, or `none`.
- `creator` string: The creator: a user id, a thread id, `me` for the key's own user, or `none`.
- `mentioned` union: Issues that mention any of these people: a user id, or `me` for the key's own user. `true` is `me`.
  - string
  - string[]
- `mentionedNot` 'true': With `mentioned`: issues that mention none of those people instead.
- `labelIds` union: Issues carrying any of these labels.
  - string
  - string[]
- `parent` string: The sub-issues of this issue code.
- `due` union: Issues due today, tomorrow, this_week (today through Sunday), next_week, this_month (today through the month's end), overdue, or none. Several, and a `dueFrom`/`dueTo` range, match any of them. Dates follow `today`.
  - 'today' | 'tomorrow' | 'this_week' | 'next_week' | 'this_month' | 'overdue' | 'none'
  - string[]
- `dueFrom` string: Issues due on or after this date (YYYY-MM-DD), inclusive.
- `dueTo` string: Issues due on or before this date (YYYY-MM-DD), inclusive.
- `dueNot` 'true': With `due`, `dueFrom` or `dueTo`: issues that match none of them instead.
- `today` string: The caller's local date for `due`; defaults to today's UTC date.
- `hasPullRequest` 'true' | 'false'
- `search` string: Words in the issue, or an issue number or code.
- `limit` integer
- `cursor` string

## Response `200`

IssuePage

- IssuePageEncoded
  - `items` IssueEncoded[], required
    - `id` string, required
    - `code` string, required
    - `number` integer, required
    - `projectId` string, required
    - `title` string, required
    - `state` IssueStateRefEncoded, required
      - `id` string, required
      - `name` string, required
      - `type` union, required
        - 'open' | 'closed'
        - string
    - `priority` union, required
      - 'urgent' | 'high' | 'normal' | 'low'
      - string
    - `dueAt` string, nullable, required
    - `parentId` string, nullable, required
    - `visibility` union, required
      - 'org' | 'private'
      - string
    - `assignees` IssueActorEncoded[], required
      - `kind` union, required
        - 'user' | 'thread'
        - string
      - `id` string, required: A user id for `user`, resolved by `GET /users`, or a thread id for `thread`.
      - `code` string, nullable, required: The thread's reference, such as `SCO-123`; null for a user or a thread the key cannot read.
    - `labels` IssueLabelRefEncoded[], required
      - `id` string, required
      - `name` string, required
    - `subIssueCount` integer, required
    - `closedSubIssueCount` integer, required
    - `openBlockerCount` integer, required: Open issues the key can read that block this one.
    - `createdAt` string, required
    - `updatedAt` string, required
    - `closedAt` string, nullable, required
  - `cursor` string, nullable, required

## Other responses

- `400`: capy/InvalidRequest
- `401`: capy/Unauthorized
- `403`: capy/Forbidden
- `404`: capy/IssueNotFound
- `429`: capy/RateLimited

## Changes

- **2026-10-31** `87f3b0aedb53`: 6 info
  - added the new optional `query` request parameter `dueFrom`
  - added the new optional `query` request parameter `dueNot`
  - added the new optional `query` request parameter `dueTo`
  - added the new optional `query` request parameter `mentionedNot`
  - …2 more
- **2026-10-31** `e3be47264feb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/capy/apis/capy-api/changes/api/v1/issues/get.md)

---

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