--- title: "Get issues for backlog (enhanced)" method: GET path: "/rest/software/1.0/board/{boardId}/backlog" tags: ["Board"] --- # Get issues for backlog (enhanced) `GET /rest/software/1.0/board/{boardId}/backlog` Returns all issues from the board's backlog, for the given board ID. Result pagination is token based, using `nextPageToken` and `maxResults`. This only includes issues that the user has permission to view. Note, if the user does not have permission to view the board, no issues will be returned at all. The backlog contains incomplete issues that are not assigned to any future or active sprint. Issues returned from this resource include Software project fields, like sprint, closedSprints, flagged, and epic. By default, the returned issues are ordered by rank. ## Path parameters - `boardId` integer, required ## Query parameters - `nextPageToken` string - `maxResults` integer - `reconcileIssues` integer[] - `jql` string - `validateQuery` boolean - `fields` object[] - `expand` string ## Response `200` Returns the requested issues, at the specified page of the results. - SoftwareIssueResults — The result of an issue search in Jira Software APIs. - `expand` string — Expand options that include additional search result details in the response. - `isLast` boolean — Indicates whether this is the last page of the paginated response. - `issues` IssueBean[] — The list of issues found by the search. - `changelog` object — A page of changelogs. - `histories` object[] — The list of changelogs. - `author` object — User details permitted by the user's Atlassian Account privacy settings. However, be aware of these exceptions: * User record deleted from Atlassian: This occurs as the result of a right to be forgotten request. In this case, `displayName` provides an indication and other parameters have default values or are blank (for example, email is blank). * User record corrupted: This occurs as a results of events such as a server import and can only happen to deleted users. In this case, `accountId` returns *unknown* and all other parameters have fallback values. * User record unavailable: This usually occurs due to an internal service outage. In this case, all parameters have fallback values. - `accountId` string — The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, *5b10ac8d82e05b22cc7d4ef5*. - `accountType` string — The type of account represented by this user. This will be one of 'atlassian' (normal users), 'app' (application user) or 'customer' (Jira Service Desk customer user) - `active` boolean — Whether the user is active. - `avatarUrls` object — The avatars of the user. - `16x16` string, uri — The URL of the item's 16x16 pixel avatar. - `24x24` string, uri — The URL of the item's 24x24 pixel avatar. - `32x32` string, uri — The URL of the item's 32x32 pixel avatar. - `48x48` string, uri — The URL of the item's 48x48 pixel avatar. - `displayName` string — The display name of the user. Depending on the user’s privacy settings, this may return an alternative value. - `emailAddress` string — The email address of the user. Depending on the user’s privacy settings, this may be returned as null. - `key` string — This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details. - `name` string — This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details. - `self` string — The URL of the user. - `timeZone` string — The time zone specified in the user's profile. Depending on the user’s privacy settings, this may be returned as null. - `created` string, date-time — The date on which the change took place. - `historyMetadata` object — Details of issue history metadata. - `activityDescription` string — The activity described in the history record. - `activityDescriptionKey` string — The key of the activity described in the history record. - `actor` object — Details of user or system associated with a issue history metadata item. - `avatarUrl` string — The URL to an avatar for the user or system associated with a history record. - `displayName` string — The display name of the user or system associated with a history record. - `displayNameKey` string — The key of the display name of the user or system associated with a history record. - `id` string — The ID of the user or system associated with a history record. - `type` string — The type of the user or system associated with a history record. - `url` string — The URL of the user or system associated with a history record. - `cause` object — Details of user or system associated with a issue history metadata item. - `avatarUrl` string — The URL to an avatar for the user or system associated with a history record. - `displayName` string — The display name of the user or system associated with a history record. - `displayNameKey` string — The key of the display name of the user or system associated with a history record. - `id` string — The ID of the user or system associated with a history record. - `type` string — The type of the user or system associated with a history record. - `url` string — The URL of the user or system associated with a history record. - `description` string — The description of the history record. - `descriptionKey` string — The description key of the history record. - `emailDescription` string — The description of the email address associated the history record. - `emailDescriptionKey` string — The description key of the email address associated the history record. - `extraData` object — Additional arbitrary information about the history record. - `generator` object — Details of user or system associated with a issue history metadata item. - `avatarUrl` string — The URL to an avatar for the user or system associated with a history record. - `displayName` string — The display name of the user or system associated with a history record. - `displayNameKey` string — The key of the display name of the user or system associated with a history record. - `id` string — The ID of the user or system associated with a history record. - `type` string — The type of the user or system associated with a history record. - `url` string — The URL of the user or system associated with a history record. - `type` string — The type of the history record. - `id` string — The ID of the changelog. - `items` object[] — The list of items changed. - `field` string — The name of the field changed. - `fieldId` string — The ID of the field changed. - `fieldtype` string — The type of the field changed. - `from` string — The details of the original value. - `fromString` string — The details of the original value as a string. - `to` string — The details of the new value. - `toString` string — The details of the new value as a string. - `maxResults` integer — The maximum number of results that could be on the page. - `startAt` integer — The index of the first item returned on the page. - `total` integer — The number of results on the page. - `editmeta` object — A list of editable field details. - `fields` object - `expand` string — Expand options that include additional issue details in the response. - `fields` object - `fieldsToInclude` object - `actuallyIncluded` string[] - `excluded` string[] - `included` string[] - `id` string — The ID of the issue. - `key` string — The key of the issue. - `names` object — The ID and name of each field present on the issue. - `operations` Operations — Details of the operations that can be performed on the issue. - `linkGroups` LinkGroup[] — Details of the link groups defining issue operations. - `groups` LinkGroup[] - `header` object — Details about the operations available in this version. - `href` string - `iconClass` string - `id` string - `label` string - `styleClass` string - `title` string - `weight` integer - `id` string - `links` object[] - `href` string - `iconClass` string - `id` string - `label` string - `styleClass` string - `title` string - `weight` integer - `styleClass` string - `weight` integer - `properties` object — Details of the issue properties identified in the request. - `renderedFields` object — The rendered value of each field present on the issue. - `schema` object — The schema describing each field present on the issue. - `self` string, uri — The URL of the issue details. - `transitions` object[] — The transitions that can be performed on the issue. - `expand` string — Expand options that include additional transition details in the response. - `fields` object — Details of the fields associated with the issue transition screen. Use this information to populate `fields` and `update` in a transition request. - `hasScreen` boolean — Whether there is a screen associated with the issue transition. - `id` string — The ID of the issue transition. Required when specifying a transition to undertake. - `isAvailable` boolean — Whether the transition is available to be performed. - `isConditional` boolean — Whether the issue has to meet criteria before the issue transition is applied. - `isGlobal` boolean — Whether the issue transition is global, that is, the transition is applied to issues regardless of their status. - `isInitial` boolean — Whether this is the initial issue transition for the workflow. - `looped` boolean - `name` string — The name of the issue transition. - `to` object — A status. - `description` string — The description of the status. - `iconUrl` string — The URL of the icon used to represent the status. - `id` string — The ID of the status. - `name` string — The name of the status. - `scope` object — The projects the item is associated with. Indicated for items associated with [next-gen projects](https://confluence.atlassian.com/x/loMyO). - `project` object — Details about a project. - `avatarUrls` object — The URLs of the project's avatars. - … - `id` string — The ID of the project. - `key` string — The key of the project. - `name` string — The name of the project. - `projectCategory` object — A project category. - … - `projectTypeKey` 'software' | 'service_desk' | 'business' — The [project type](https://confluence.atlassian.com/x/GwiiLQ#Jiraapplicationsoverview-Productfeaturesandprojecttypes) of the project. - `self` string — The URL of the project details. - `simplified` boolean — Whether or not the project is simplified. - `type` 'PROJECT' | 'TEMPLATE' — The type of scope. - `self` string — The URL of the status. - `statusCategory` object — A status category. - `colorName` string — The name of the color used to represent the status category. - `id` integer — The ID of the status category. - `key` string — The key of the status category. - `name` string — The name of the status category. - `self` string — The URL of the status category. - `versionedRepresentations` object — The versions of each field on the issue. - `names` object — The ID and name of each field in the search results. - `nextPageToken` string — Continuation token to fetch the next page. If this result represents the last or only page, this token will be null. - `schema` object — The schema describing the field types in the search results. - `warningMessages` string[] — Any warnings related to the JQL query. ## 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 a valid license. - `404` — Returned if the board does not exist or the user does not have permission to view it. --- [API](https://skmtc.net/atlassian/apis/jira-software-cloud-api.md) · [All operations](https://skmtc.net/atlassian/apis/jira-software-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/jira-software-cloud-api/versions/4e108d54b990/schema)