---
title: "Get plans paginated"
method: GET
path: "/rest/api/3/plans/plan"
tags: ["Plans"]
---

# Get plans paginated

`GET /rest/api/3/plans/plan`

Returns a [paginated](#pagination) list of plans.

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Query parameters

- `includeTrashed` boolean
- `includeArchived` boolean
- `cursor` string
- `maxResults` integer

## Response `200`

Returned if the request is successful.

- PageWithCursorGetPlanResponseForPage
  - `cursor` string
  - `last` boolean
  - `nextPageCursor` string
  - `size` integer
  - `total` integer
  - `values` GetPlanResponseForPage[]
    - `id` string, required — The plan ID.
    - `issueSources` GetIssueSourceResponse[] — The issue sources included in the plan.
      - `type` 'Board' | 'Project' | 'Filter' | 'Custom', required — The issue source type. This is "Board", "Project" or "Filter".
      - `value` integer, required — The issue source value. This is a board ID if the type is "Board", a project ID if the type is "Project" or a filter ID if the type is "Filter".
    - `name` string, required — The plan name.
    - `scenarioId` string, required — Default scenario ID.
    - `status` 'Active' | 'Trashed' | 'Archived', required — The plan status. This is "Active", "Trashed" or "Archived".

## Other responses

- `401` — Returned if the user is not logged in.
- `403` — Returned if the site has no premium edition of Jira or if the user does not have the Administer Jira global permission.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/ec7f275dfee5/schema)