Get Bound Package Versions

Description: Returns a list of package versions that are bound with the specified application.

Since: AppTrust 1.16.4

Usage: GET https://{{artifactory-host}}/apptrust/api/v1/applications/{{application_key}}/packages/{type}/{name}

Path Parameters (required):

Parameter	Type	Description
`application_key`	string	The unique identifier for the application.
`type`	string	The package type (for example, `maven`, `docker`).
`name`	string	The package name.

Query Parameters (optional):

Parameter	Type	Description
`offset`	integer	Sets the number of records to skip for pagination purposes. The default value is `0`.
`limit`	integer	Sets the maximum number of versions to return at one time (up to 250). The default value is `25`.
`package_version`	string	The package version. If not defined, all package versions are returned.

Consumes: application/json

Response Body:

Property	Type	Description
`versions`	array:object	An array of package version objects, as described below.
`versions.version`	string	The package version.
`versions.vcs_url`	string	The source control URL associated with the package version.
`versions.vcs_branch`	string	The source control branch from which the package version was built, if available.
`versions.vcs_revision`	string	The source control revision (for example, the commit hash) of the package version, if available.
`total`	integer	The limit value used for this request.
`offset`	integer	The total number of bound versions for this package.
`limit`	integer	The offset value used for this request.

Sample Request:

GET 'https://{host}.jfrog.io/apptrust/api/v1/applications/web-portal-app/packages/maven/org.apache.tomcat:catalina?limit=2&order_by=version&order_asc=false'
Authorization: ••••••

Sample Response:

{
  "versions": [
    {
      "version": "2.5.1",
      "vcs_url": "https://github.com/my-org/web-portal.git",
      "vcs_branch": "main",
      "vcs_revision": "a1b2c3d4e5f67890"
    },
    {
      "version": "2.5.0",
      "vcs_url": "https://github.com/my-org/web-portal.git",
      "vcs_branch": "feature/new-ui",
      "vcs_revision": "f6e5d4c3b2a10987"
    }
  ],
  "offset": 0,
  "limit": 2,
  "total": 5
}

Status Codes:

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