---
updatedAt: 2026-07-12T09:38:47.000Z
agentTools:
  siteIndex: https://docs.jfrog.com/llms.txt
  projectIndex: https://docs.jfrog.com/governance/llms.txt
---

# Get Application Versions

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

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "contact": {},
    "description": "This is the API documentation for the AppTrust Service.",
    "title": "AppTrust Service API",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://{jfrog_url}/apptrust/api",
      "description": "JFrog Platform",
      "variables": {
        "jfrog_url": {
          "default": "myserver.jfrog.io",
          "description": "Your JFrog Platform hostname (e.g., mycompany.jfrog.io)"
        }
      }
    }
  ],
  "paths": {
    "/v1/applications/{application_key}/versions": {
      "get": {
        "description": "Returns a list of application versions associated with the specified application key.",
        "operationId": "getApplicationVersions",
        "parameters": [
          {
            "description": "The unique identifier for the application.",
            "in": "path",
            "name": "application_key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "When true, returns only versions currently monitored by the application's Support Window policy. Only true is supported.",
            "in": "query",
            "name": "monitored",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Filters by the release status of the application version:<br>- released: Versions that have been released to PROD.<br>- pre_release: Versions at stages prior to PROD.<br>- trusted_release: Versions that were released to PROD after a successful evaluation at the PROD release gate.<br>Supports multiple comma-separated values.",
            "in": "query",
            "name": "release_status",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filters by the assigned tag. Supports a trailing wildcard (*) and multiple comma-separated values.",
            "in": "query",
            "name": "tag",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Sorts the list of application versions by the specified field.<br>The default is created.",
            "in": "query",
            "name": "order_by",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Defines whether to list the versions in ascending (true) or descending (false) order.<br>The default value is false.",
            "in": "query",
            "name": "order_asc",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Sets the maximum number of versions to return at one time. Used for pagination purposes.",
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer"
            }
          },
          {
            "description": "Sets the number of records to skip before returning the query response. Used for pagination purposes.",
            "in": "query",
            "name": "offset",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/response.ApplicationVersionsResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors.Errors"
                }
              }
            },
            "description": "Bad Request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors.Errors"
                }
              }
            },
            "description": "Bad Credentials"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors.Errors"
                }
              }
            },
            "description": "Permission Denied"
          }
        },
        "summary": "Get Application Versions",
        "tags": [
          "Application version"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "errors.Error": {
        "example": {
          "details": [
            "details",
            "details"
          ],
          "message": "message"
        },
        "properties": {
          "details": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "message": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "errors.Errors": {
        "example": {
          "errors": [
            {
              "details": [
                "details",
                "details"
              ],
              "message": "message"
            },
            {
              "details": [
                "details",
                "details"
              ],
              "message": "message"
            }
          ]
        },
        "properties": {
          "errors": {
            "items": {
              "$ref": "#/components/schemas/errors.Error"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "response.ApplicationVersion": {
        "example": {
          "current_promotion_created": "2026-04-10T15:00:00Z",
          "created": "2026-04-01T09:30:00Z",
          "draft": false,
          "messages": [
            {
              "text": "Promotion completed successfully."
            },
            {
              "text": "Promotion completed successfully."
            }
          ],
          "current_stage": "dev",
          "tag": "release-2.1.0",
          "application_key": "my-payment-service",
          "created_by": "alice@example.com",
          "release_status": "not_released",
          "version": "2.1.0",
          "status": "active"
        },
        "properties": {
          "application_key": {
            "description": "The application key.",
            "example": "my-payment-service",
            "type": "string"
          },
          "created": {
            "description": "Timestamp of when the version was created (ISO 8601).",
            "example": "2026-04-01T09:30:00Z",
            "type": "string"
          },
          "created_by": {
            "description": "The user who created the version.",
            "example": "alice@example.com",
            "type": "string"
          },
          "current_promotion_created": {
            "description": "Timestamp of the current promotion.",
            "example": "2026-04-10T15:00:00Z",
            "type": "string"
          },
          "current_stage": {
            "description": "The current lifecycle stage of the version.",
            "example": "dev",
            "type": "string"
          },
          "draft": {
            "description": "Whether the version is a draft.",
            "example": false,
            "type": "boolean"
          },
          "messages": {
            "description": "Messages associated with the version creation.",
            "items": {
              "$ref": "#/components/schemas/response.ApplicationVersionMessage"
            },
            "type": "array"
          },
          "release_status": {
            "description": "The release status of the version.",
            "example": "not_released",
            "type": "string"
          },
          "sla": {
            "allOf": [
              {
                "$ref": "#/components/schemas/response.ApplicationVersionSla"
              }
            ],
            "description": "Support window state for the version. Returns type \"none\" when no monitor policy is configured."
          },
          "status": {
            "description": "The status of the application version.",
            "example": "active",
            "type": "string"
          },
          "tag": {
            "description": "The tag associated with the version.",
            "example": "release-2.1.0",
            "type": "string"
          },
          "version": {
            "description": "The application version identifier.",
            "example": "2.1.0",
            "type": "string"
          }
        },
        "type": "object"
      },
      "response.ApplicationVersionSla": {
        "description": "Support window state of a version.",
        "example": {
          "type": "days_left",
          "value": 42,
          "message": "42 days left"
        },
        "properties": {
          "type": {
            "description": "Support window state type (days_left, version_count, or none).",
            "example": "days_left",
            "type": "string"
          },
          "value": {
            "description": "Remaining budget: positive while the window is open, zero when it has ended or type is none.",
            "example": 42,
            "type": "integer"
          },
          "message": {
            "description": "Human-readable remaining budget, for example \"42 days left\", \"2 versions left\", or \"Support window ended\".",
            "example": "42 days left",
            "type": "string"
          }
        },
        "type": "object"
      },
      "response.ApplicationVersionMessage": {
        "example": {
          "text": "Promotion completed successfully."
        },
        "properties": {
          "text": {
            "description": "The message text.",
            "example": "Promotion completed successfully.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "response.ApplicationVersionsResponse": {
        "example": {
          "total": 100,
          "offset": 0,
          "versions": [
            {
              "current_promotion_created": "2026-04-10T15:00:00Z",
              "created": "2026-04-01T09:30:00Z",
              "draft": false,
              "messages": [
                {
                  "text": "Promotion completed successfully."
                },
                {
                  "text": "Promotion completed successfully."
                }
              ],
              "current_stage": "dev",
              "tag": "release-2.1.0",
              "application_key": "my-payment-service",
              "created_by": "alice@example.com",
              "release_status": "not_released",
              "version": "2.1.0",
              "status": "active"
            },
            {
              "current_promotion_created": "2026-04-10T15:00:00Z",
              "created": "2026-04-01T09:30:00Z",
              "draft": false,
              "messages": [
                {
                  "text": "Promotion completed successfully."
                },
                {
                  "text": "Promotion completed successfully."
                }
              ],
              "current_stage": "dev",
              "tag": "release-2.1.0",
              "application_key": "my-payment-service",
              "created_by": "alice@example.com",
              "release_status": "not_released",
              "version": "2.1.0",
              "status": "active"
            }
          ],
          "limit": 50
        },
        "properties": {
          "limit": {
            "description": "Maximum number of versions returned.",
            "example": 50,
            "type": "integer"
          },
          "offset": {
            "description": "Number of records skipped before returning the response.",
            "example": 0,
            "type": "integer"
          },
          "total": {
            "description": "Total number of application versions matching the query.",
            "example": 100,
            "type": "integer"
          },
          "versions": {
            "description": "Array of application version objects.",
            "items": {
              "$ref": "#/components/schemas/response.ApplicationVersion"
            },
            "type": "array"
          }
        },
        "type": "object"
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "x-original-swagger-version": "2.0",
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```