Get Application Versions

Description: Returns a list of application versions associated with the specified application key.

Since: AppTrust 1.16.4

Usage: POST https://{{artifactory-host}}/apptrust/api/v1/applications/{{application_key}}/versions

Request Parameters:

Query Parameters (optional):

Parameter	Type	Description
`created_by`	string	Filters by the user who created the application version.
`release_status`	string	Filters by the release status of the application version: `released`: Versions that have been released to PROD. `pre_release`: Versions at stages prior to PROD. `trusted_release`: Versions that were released to PROD after a successful evaluation at the PROD release gate. Supports multiple comma-separated values.
`tag`	string	Filters by the assigned tag. Supports a trailing wildcard (*) and multiple comma-separated values.
`offset`	integer	Sets the number of records to skip before returning the query response. Used for pagination purposes.
`limit`	integer	Sets the maximum number of versions to return at one time. Used for pagination purposes.
`order_asc`	boolean	Defines whether to list the promotions in ascending (`true`) or descending (`false`) order. The default value is `false`.

Consumes: application/json

Response Body:

Property	Type	Description
`version`	string	The version identifier, typically based on semantic versioning (SemVer; for example, v2.1.3).
`tag`	string	The tag assigned to the version to help identify and group it. It typically represents the branch (for example, `latest`, `stable`, `beta`, etc.).
`status`	string	The current status of the version based on the latest action performed (for example, `success`, `pending`, `failed`).
`release_status`	string	The release status of the application version. `released`: Has been released to PROD. `pre_release`: Is at a stage prior to PROD. `trusted_release`: Was released to PROD after a successful evaluation at the PROD release gate.
`current_stage`	string	The most recent stage (e.g. QA, Staging) to which the version was promoted successfully. This value will be empty if the version has yet to be promoted.
`created_by`	string	The name of the user or process that created this version.
`created`	string	The date and time when this version was created (ISO 8601 format).

Sample Request:

GET 'https://{host}.jfrog.io/apptrust/api/v1/applications/catalina-app/versions?limit=3&release_status=pre_release' Authorization: ••••••

Sample Response:

{
  "versions": [
    {
      "version": "1.0.1",
      "tag": "release",
      "status": "COMPLETED",
      "release_status": "pre_release",
      "current_stage": "QA",
      "created_by": "user@example.com",
      "created": "2025-07-15T09:30:00Z"
    },
    {
      "version": "1.0.0",
      "tag": "stable",
      "status": "COMPLETED",
      "release_status": "trusted_release",
      "current_stage": "PROD",
      "created_by": "user@example.com",
      "created": "2025-07-14T11:20:15Z"
    },
    {
      "version": "0.9.0-beta",
      "tag": "beta",
      "status": "FAILED",
      "release_status": "pre_release",
      "current_stage": "",
      "created_by": "automation-service",
      "created": "2025-07-11T18:05:00Z"
    }
  ],
  "total": 3,
  "limit": 3,
  "offset": 0
}

Status Codes:

Code	Description
200	Success
400	Bad Request
401	Bad Credentials
403	Permission Denied
404	Not Found