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: |
-
descriptionSorts by version description. -
nameSorts by version name. -
releaseDateSorts by release date, starting with the oldest date. Versions with no release date are listed last. -
sequenceSorts by the order of appearance in the user interface. -
startDateSorts 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 matchingnameordescriptionare 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: -
issuesstatusReturns the number of issues in each status category for each version. -
operationsReturns 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}}]}