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

# List Plans

`GET /api/v1/plans`

List all plans, optionally filtered by status.

Query params:
    status: Filter by plan status (pending, approved, rejected, expired).

## Query parameters

- `status` string, nullable

## Response `200`

Successful Response

- object[]

## Other responses

- `400` — Invalid status filter
- `404` — Plan mode is not enabled on this server
- `422` — Validation Error

## Changes

> 15 revisions in range; 7 could not be searched.

- **2026-07-26** `86f514b4e920` — 2 info
  - added the non-success response with the status `404`
  - removed the non-success response with the status `503`
- **2026-07-26** `2a1299ef19fa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server/changes/api/v1/plans/get.md)

---

[API](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sipyourdrink-ltd/bernstein-task-server/revisions/7f4871ff054a/schema)