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

KeyDatatypeRequiredDescription
startAtnumberThe index of the first item to return in a page of results (page offset).
maxResultsnumberThe maximum number of items to return per page.
orderBystringOrder 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 matching name or description 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 are released, unreleased, and archived. | | 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

{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/project/PR/version?startAt=0\u0026maxResults=2&quot;,&quot;nextPage&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/project/PR/version?startAt=2\u0026maxResults=2&quot;,&quot;maxResults&quot;:2,&quot;startAt&quot;:0,&quot;total&quot;:7,&quot;isLast&quot;:false,&quot;values&quot;:[{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/version/10000&quot;,&quot;id&quot;:&quot;10000&quot;,&quot;description&quot;:&quot;An excellent version&quot;,&quot;name&quot;:&quot;New Version 1&quot;,&quot;archived&quot;:false,&quot;released&quot;:true,&quot;releaseDate&quot;:&quot;2010-07-06&quot;,&quot;overdue&quot;:true,&quot;userReleaseDate&quot;:&quot;6/Jul/2010&quot;,&quot;projectId&quot;:10000},{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/version/10010&quot;,&quot;id&quot;:&quot;10010&quot;,&quot;description&quot;:&quot;Minor Bugfix version&quot;,&quot;name&quot;:&quot;Next Version&quot;,&quot;archived&quot;:false,&quot;released&quot;:false,&quot;overdue&quot;:false,&quot;projectId&quot;:10000,&quot;issuesStatusForFixVersion&quot;:{&quot;unmapped&quot;:0,&quot;toDo&quot;:10,&quot;inProgress&quot;:20,&quot;done&quot;:100}}]}