---
title: "List planning statuses for a repository"
method: GET
path: "/repos/{owner}/{repo}/planning-statuses"
tags: ["repos"]
---

# List planning statuses for a repository

`GET /repos/{owner}/{repo}/planning-statuses`

## Request

- Base URL: `https://api.github.com`
- URL: `https://api.github.com/repos/{owner}/{repo}/planning-statuses`
- Auth: none declared

Lists the selectable planning statuses available.
Planning statuses are returned in deterministic display order:
Backlog, Todo, In progress, In review, Done, Not planned, and Duplicate.
Clients should expect new keys to be added.
Returns `404 Not Found` when issue statuses aren't available in the repository.

> [!NOTE]
> Issue statuses are in preview and subject to change. They're only available to accounts enrolled in the preview.

You need read access to the repository's issues to use this endpoint.

OAuth app tokens and personal access tokens (classic) need the `repo` scope
to use this endpoint with a private repository.

Fine-grained access tokens require the "Issues" repository permission (read).

## Path parameters

- `owner` string, required
- `repo` string, required

## Response `200`

Available planning statuses in display order

- PlanningStatus[]
  - `id` integer, required: The stable identifier of the planning status.
  - `name` string, required: The display name of the planning status, which may change in the future.
  - `category` string, required: A stable identifier for the category, such as `backlog`, `planned`, `started`, `completed`, `not_planned` or `duplicate`. Clients should expect new keys to be added.

## Other responses

- `404`: Resource not found

## Changes

> 735 revisions in range; 1 not diffed.

- **2026-11-13** `700f1736010f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/github/apis/rest/changes/repos/:owner/:repo/planning-statuses/get.md)

---

[API](https://skmtc.dev/github/apis/rest.md) - [All operations](https://skmtc.dev/github/apis/rest/llms.txt) - [OpenAPI document](https://skmtc.dev/github/apis/rest/revisions/6c33400fa143?raw)