Get Project Versions Paginated
GET {{baseUrl}}/rest/api/3/project/:projectIdOrKey/version?startAt=0&maxResults=50&orderBy=<string>&query=<string>&status=<string>&expand=<string>
Returns a paginated list of all versions in a project. See the Get project versions resource if you want to get a full list of versions without pagination.
This operation can be accessed anonymously.
Permissions required: Browse Projects project permission for the project.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
startAt | number | The index of the first item to return in a page of results (page offset). | |
maxResults | number | The maximum number of items to return per page. | |
orderBy | string | Order the results by a field: |
-
description
Sorts by version description. -
name
Sorts by version name. -
releaseDate
Sorts by release date, starting with the oldest date. Versions with no release date are listed last. -
sequence
Sorts by the order of appearance in the user interface. -
startDate
Sorts by start date, starting with the oldest date. Versions with no start date are listed last. | |query
| string | | Filter the results using a literal string. Versions with matchingname
ordescription
are returned (case insensitive). | |status
| string | | A list of status values used to filter the results by version status. This parameter accepts a comma-separated list. The status values arereleased
,unreleased
, andarchived
. | |expand
| string | | Use expand to include additional information in the response. This parameter accepts a comma-separated list. Expand options include: -
issuesstatus
Returns the number of issues in each status category for each version. -
operations
Returns actions that can be performed on the specified version. |
RESPONSES
status: OK
{"self":"https://your-domain.atlassian.net/rest/api/3/project/PR/version?startAt=0\u0026maxResults=2","nextPage":"https://your-domain.atlassian.net/rest/api/3/project/PR/version?startAt=2\u0026maxResults=2","maxResults":2,"startAt":0,"total":7,"isLast":false,"values":[{"self":"https://your-domain.atlassian.net/rest/api/3/version/10000","id":"10000","description":"An excellent version","name":"New Version 1","archived":false,"released":true,"releaseDate":"2010-07-06","overdue":true,"userReleaseDate":"6/Jul/2010","projectId":10000},{"self":"https://your-domain.atlassian.net/rest/api/3/version/10010","id":"10010","description":"Minor Bugfix version","name":"Next Version","archived":false,"released":false,"overdue":false,"projectId":10000,"issuesStatusForFixVersion":{"unmapped":0,"toDo":10,"inProgress":20,"done":100}}]}