---
title: "Get epics"
method: GET
path: "/rest/agile/1.0/board/{boardId}/epic"
tags: ["Board"]
---

# Get epics

`GET /rest/agile/1.0/board/{boardId}/epic`

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/agile/1.0/board/{boardId}/epic`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `https://auth.atlassian.com/authorize`
    - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `read:epic:jira-software`

Returns all epics from the board, for the given board ID. This only includes epics that the user has permission to view. Note, if the user does not have permission to view the board, no epics will be returned at all.

## Path parameters

- `boardId` integer, required

## Query parameters

- `startAt` integer
- `maxResults` integer
- `done` string

## Response `200`

Returns the requested epics, at the specified page of the results.

## Other responses

- `400`: Returned if the request is invalid.
- `401`: Returned if the user is not logged in.
- `403`: Returned if the user does not have valid license.
- `404`: Returned if board does not exist or the user does not have permission to view it.

## Changes

- **2026-07-13** `4e108d54b990`: 1 info
  - the endpoint scheme security `basicAuth` was added to the API
- **2022-09-25** `ac057c9cf7e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/atlassian/apis/jira-software-cloud-api/changes/rest/agile/1.0/board/:boardId/epic/get.md)

---

[API](https://skmtc.dev/atlassian/apis/jira-software-cloud-api.md) - [All operations](https://skmtc.dev/atlassian/apis/jira-software-cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/jira-software-cloud-api/revisions/4e108d54b990?raw)