Get Application Version Content

JFrog REST APIs

Content Type
REST API

Description: Returns detailed content for a specified application version, including its components (artifacts, packages, builds), sources, and the ownership details for each component.

Since: AppTrust 1.16.4

Usage: GET https://{{artifactory-host}}/apptrust/api/v1/applications/{{application_key}}/versions/{{version}}/content

Query Parameters (optional):

Parameter

Type

Description

offset

integer

The number of records to skip for pagination.

The default is 0.

limit

integer

The maximum number of records to return (up to 250).

The default is 25.

include

string

The level of detail in the response. Can be one of the following:

  • sources: The source of the content (typically, an application).

  • releasables: The package or standalone artifact to be released as part of the version.

  • releasables_expanded: Includes expanded details about the releasables.

order_by

string

The field and order by which to sort the results, using the format field:order.

Supported fields: name, package_type

Supported order: asc, desc

The default is name:asc

Response Body:

Parameter

Type

Description

application_key

string

The application key related to the version.

version

string

The version identifier.

project_key

string

The project key to which the application is associated.

application_version_sha256

string

The application version digest.

status

string

The status of the last operation performed on this application version.

created_by

string

The user ID who created this application version.

created_at

string

The date and time when this version was created (ISO 8601 format).

tag

string

The user-defined tag associated with the version, if any.

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.

releasables_count

integer

The total number of releasables in the version.

artifacts_count

integer

The total number of artifacts in the version.

total_size

integer

The total size of all artifacts in the version (in bytes).

releasables

array:object

An array of releasable items included in the bundle.

releasables.name

string

The name of the releasable (for example, the package or artifact name).

releasables.version

string

The package version. (Empty for non-package releasables.)

releasables.releasable_type

string

The type of releasable: artifact or package_version

releasables.sha256

string

The SHA256 checksum of the leading file.

releasables.package_type

string

The package type (for example, docker, maven, generic).

releasables.owning_application_key

string

The application key of the application that owns this releasable. null for 3rd party releasables.

releasables.connection_level

string

The relationship of the releasable to the current application:

  • 1st_party: The releasable is owned by this application.

  • 2nd_party: The releasable is owned by a different application within your organization.

  • 3rd_party: The releasable originates from outside your organization.

  • unknown

releasables.total_size

integer

The total size of all artifacts in the releasable (in bytes).

releasables.sources

array:object

Describes how the releasable was added to this version.

releasables.sources.type

string

The source type:

  • application_version

  • release_bundle

  • build

  • direct: The releasable was added directly to the version.

releasables.sources.application_version.application_key

string

The application key of the source application.

Exists only when the source type is application_version.

releasables.sources.application_version.version

string

The version of the source application.

Exists only when the source type is application_version.

releasables.sources.release_bundle.name

string

The name of the source Release Bundle.

Exists only when the source type is release_bundle.

releasables.sources.release_bundle.version

string

The version of the source Release Bundle.

Exists only when the source type is release_bundle.

releasables.sources.release_bundle.repo_key

string

The repository key where the source Release Bundle is stored.

Exists only when the source type is release_bundle.

releasables.sources.build.name

string

The source build name.

Exists only when the source type is build.

releasables.sources.build.number

string

The source build number.

Exists only when the source type is build.

releasables.sources.build.timestamp

string

The timestamp of when the build was created.

Exists only when the source type is build.

releasables.sources.build.repo_key

string

The repository key of the build-info repository.

Exists only when the source type is build.

releasables.artifacts

array:object

An array of artifacts that are part of this releasable.

releasables.artifacts.path

string

The repository path to the artifact.

releasables.artifacts.sha256

string

The SHA256 checksum of the artifact.

releasables.artifacts.size

integer

The size of the artifact in bytes.

sources

array:object

A hierarchical list of sources from which version was created.

sources.type

string

The source type:

  • release_bundle

  • build

  • direct

sources.build

object

Details when the source type is build.

sources.build.name

string

The source build name.

sources.build.number

string

The source build number.

sources.build.timestamp

string

The timestamp of when the build was created.

sources.build.repo_key

string

The repository key of the build-info repository.

sources.release_bundle

object

Details when the source type is release_bundle.

sources.release_bundle.name

string

The source Release Bundle name.

sources.release_bundle.version

string

The source Release Bundle version.

sources.release_bundle.repo_key

string

The repository key where the source Release Bundle is stored.

sources.application_version

string

Details when the source type is application_version.

sources.application_version.application_key

string

The name of the source application version.

Exists only when the source type is application_version.

sources.application_version.version

string

The source application version.

Exists only when the source type is application_version.

sources.child_sources

array:object

A nested array of source objects, creating a hierarchy.

offset

integer

The offset value used for this request.

limit

integer

The limit value used for this request.

Sample Request:

GET 'https://{host}.jfrog.io/apptrust/api/v1/applications/my-super-app/versions/1.2.3/content?include=releasables'
Authorization: ••••••

Sample Response (include=null):

{
  "application_key": "my-super-app",
  "version": "1.2.3",
  "project_key": "super-proj",
  "status": "COMPLETED",
  "created_by": "user@example.com",
  "created_at": "2025-07-15T08:58:00Z",
  "tag": "stable-release",
  "release_status": "pre_release",
  "releasables_count": 3,
  "artifacts_count": 5,
  "total_size": 15822848
}

Sample Response (include=sources):

{
  "application_key": "my-super-app",
  "version": "1.2.3",
  "project_key": "super-proj",
  "status": "COMPLETED",
  "created_by": "user@example.com",
  "created_at": "2025-07-15T08:58:00Z",
  "tag": "stable-release",
  "release_status": "pre_release",
  "releasables_count": 3,
  "artifacts_count": 5,
  "total_size": 15822848,
  "sources": [
    {
      "type": "build",
      "build": { "name": "my-super-app-build", "number": "15", "timestamp": "2023-10-27T08:00:00.000Z", "repo_key": "artifactory-build-info"  }
    },
    {
      "type": "version",
      "version": { "application_key": "shared-services-app", "version": "2.5.0" },
      "child_sources": [
        {
          "type": "build",
          "build": { "name": "shared-services-build", "number": "42", "timestamp": "2023-10-27T08:00:00.000Z", "repo_key": "artifactory-build-info" }
        }
      ]
    },
    {
      "type": "direct"
    }
  ]
}

Sample Response (include=releasables):

{
  "application_key": "my-super-app",
  "version": "1.2.3",
  "project_key": "super-proj",
  "status": "COMPLETED",
  "created_by": "user@example.com",
  "created_at": "2025-07-15T08:58:00Z",
  "tag": "stable-release",
  "release_status": "pre_release",
  "releasables_count": 3,
  "artifacts_count": 5,
  "total_size": 15822848,
  "releasables": [
    {
      "name": "my-super-app-service",
      "version": "1.2.3",
      "sha256": "a1b2c3d4e5f6...",
      "releasable_type": "package_version",
      "package_type": "docker",
      "owning_application_key": "my-super-app",
      "connection_level": "1st_party",
      "total_size": 10485760,
      "source": {
        "type": "build",
        "build": { "name": "my-super-app-build", "number": "15" }
      }
    },
    {
      "name": "com.my-org:shared-library",
      "version": "2.5.0",
      "sha256": "f6e5d4c3b2a1...",
      "releasable_type": "package_version",
      "package_type": "maven",
      "owning_application_key": "shared-services-app",
      "connection_level": "2nd_party",
      "total_size": 5242880,
      "source": {
        "type": "version",
        "version": { "application_key": "shared-services-app", "version": "2.5.0" }
      }
    },
    {
      "name": "react",
      "version": "18.2.0",
      "sha256": "c3d4e5f6a1b2...",
      "releasable_type": "package_version",
      "package_type": "npm",
      "owning_application_key": null,
      "connection_level": "3rd_party",
      "total_size": 94208,
      "source": {
        "type": "direct"
      }
    }
  ],
  "offset": 0,
  "limit": 25
}

Sample Response (include=sources, releasables_expanded):

{
  "application_key": "my-super-app",
  "version": "1.2.3",
  "project_key": "super-proj",
  "status": "COMPLETED",
  "created_by": "user@example.com",
  "created_at": "2025-07-15T08:58:00Z",
  "tag": "stable-release",
  "release_status": "pre_release",
  "releasables_count": 3,
  "artifacts_count": 5,
  "total_size": 15822848,
  "releasables": [
    {
      "name": "my-super-app-service",
      "version": "1.2.3",
      "sha256": "a1b2c3d4e5f6...",
      "releasable_type": "package_version",
      "package_type": "docker",
      "owning_application_key": "my-super-app",
      "connection_level": "1st_party",
      "total_size": 10485760,
      "source": { "type": "build", "build": { "name": "my-super-app-build", "number": "15", "timestamp": "2023-10-27T08:00:00.000Z", "repo_key": "artifactory-build-info" }},
      "artifacts": [
        { "path": "my-super-app-service/1.2.3/manifest.json", "sha256": "a1b2c3d4e5f6...", "size": 5240 },
        { "path": "my-super-app-service/1.2.3/layer1.tar.gz", "sha256": "...", "size": 10480520 }
      ]
    },
    {
      "name": "com.my-org:shared-library",
      "version": "2.5.0",
      "sha256": "f6e5d4c3b2a1...",
      "releasable_type": "package_version",
      "package_type": "maven",
      "owning_application_key": "shared-services-app",
      "connection_level": "2nd_party",
      "total_size": 5242880,
      "source": { "type": "version", "version": { "application_key": "shared-services-app", "version": "2.5.0" }},
      "artifacts": [
        { "path": "com/my-org/shared-library/2.5.0/shared-library-2.5.0.jar", "sha256": "f6e5d4c3b2a1...", "size": 5242880 }
      ]
    },
    {
      "name": "react",
      "version": "18.2.0",
      "sha256": "c3d4e5f6a1b2...",
      "releasable_type": "package_version",
      "package_type": "npm",
      "owning_application_key": null,
      "connection_level": "3rd_party",
      "total_size": 94208,
      "source": { "type": "direct" },
      "artifacts": [
        { "path": "react/-/react-18.2.0.tgz", "sha256": "c3d4e5f6a1b2...", "size": 94208 }
      ]
    }
  ],
  "sources": [
    { "type": "build", "build": { "name": "my-super-app-build", "number": "15", "timestamp": "2023-10-27T08:00:00.000Z", "repo_key": "artifactory-build-info" }},
    { "type": "version", "version": { "application_key": "shared-services-app", "version": "2.5.0" }, "child_sources": [
        { "type": "build", "build": { "name": "shared-services-build", "number": "42" }}
    ]},
    { "type": "direct" }
  ],
  "offset": 0,
  "limit": 25
}

Status Codes:

Code

Description

200

Success

400

Bad Request

401

Bad Credentials

403

Permission Denied

404

Not Found