Get Applications

Description: Returns a list of applications, including the latest version and the total number of versions.

Since: AppTrust 1.16.4

Usage: GET https://{{artifactory-host}}/apptrust/api/v1/applications/

Query Parameters (optional):

Parameter	Type	Description
`project_key`	string	The key of the project associated with the application.
`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.
`name`	string	Filters results by the application name.
`owner`	array:string	Filters results by application owners (user or group). This filter can be used multiple times (once for each owner).
`maturity`	string	Filters results by application maturity.
`criticality`	string	Filters results by application criticality.
`label`	array:string	Filters by application labels. This filter can be used multiple times (once for each label). Key and Value are separated by a colon (:).
`order_by`	string	Defines whether to order the applications by `name` or `created`. The default is `created`.
`order_asc`	boolean	Defines whether to list the application in ascending (`true`) or descending (`false`) order. The default is `false`.

Sample Request:

GET 'https://{host}.jfrog.io/apptrust/api/v1/applications?project_key=catalina&label=environment:production&label=region=us-east&owner=JohnD&owner=DevOps&prefix=backend&order_by=name&order_asc=true'
Content-Type: application/json
Authorization: ••••••

Sample Response:

{
    "applications": [
        {
            "project_name": "Catalina",
            "project_key": "catalina",
            "created": "2024-05-18T11:26:02.912Z",
            "application_name": "Catalina-App",
            "application_key": "catalina-app",
            "application_version_latest": "1.0.0",
            "application_version_tag": "stable",
            "application_versions_count": 1
        },
        {
            "project_name": "Default",
            "project_key": "default",
            "created": "2024-05-18T11:25:35.936Z",
            "application_name": "Commons-App",
            "application_key": "commons-app",
            "application_version_latest": "2.1.1",
            "application_version_tag": "nightly",
            "application_versions_count": 5
        }
    ],
    "total": 2,
    "limit": 10,
    "offset": 0
}

Status Codes:

Code	Description
200	Success
401	Bad Credentials
403	Permission Denied