---
updatedAt: 2026-09-01T08:40:22.000Z
agentTools:
  siteIndex: https://docs.jfrog.com/llms.txt
  projectIndex: https://docs.jfrog.com/governance/llms.txt
---

# Get Release Bundle v2 Versions

Returns a list of versions for a specified Release Bundle v2. Records are provided regardless of status, including failed attempts at creation. You can filter the results based on version, creator, tags, status, and where they have been promoted.

**Security:** Requires Read permissions to the target Release Bundle path.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Release Lifecycle Management API",
    "description": "API for managing release bundles in JFrog Artifactory - Based on official JFrog REST API documentation",
    "version": "3.x-SNAPSHOT",
    "contact": {
      "name": "JFrog Support",
      "url": "https://jfrog.com/help",
      "email": "support@jfrog.com"
    }
  },
  "servers": [
    {
      "url": "https://{jfrog_url}/lifecycle/api/v2",
      "description": "JFrog Platform",
      "variables": {
        "jfrog_url": {
          "default": "myserver.jfrog.io",
          "description": "Your JFrog Platform hostname (e.g., mycompany.jfrog.io)"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Release Bundle V2 Management",
      "description": "Release bundle management operations"
    }
  ],
  "paths": {
    "/release_bundle/records/{name}": {
      "get": {
        "tags": [
          "Release Bundle V2 Management"
        ],
        "summary": "Get Release Bundle v2 Versions",
        "description": "Returns a list of versions for a specified Release Bundle v2. Records are provided regardless of status, including failed attempts at creation. You can filter the results based on version, creator, tags, status, and where they have been promoted.\n\n**Security:** Requires Read permissions to the target Release Bundle path.",
        "x-since": "7.63.2",
        "operationId": "getBundleVersions",
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "description": "Release bundle name",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^\\w[\\w\\-.]*$",
              "minLength": 1
            }
          },
          {
            "name": "project",
            "in": "query",
            "description": "The project key used to determine the Release Bundles repository. By convention, each project may contain only one Release Bundles system repository with the name <project-key>-release-bundles-v2. This query parameter may be used instead of repository_key.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "repository_key",
            "in": "query",
            "description": "The Release Bundles repository identifier that identifies where a Release Bundle version resides. If this parameter and the project query parameter are not specified, the default value of release-bundles-v2 is assumed.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "description": "Adds details to the response. Supports 'messages' (returns any error messages generated when creating the Release Bundle version) and 'permissions' (returns user permissions for these versions). Multiple values can be comma-separated.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter_by",
            "in": "query",
            "description": "Defines a filter for the list of Release Bundle versions. You can filter according to release_bundle_version and created_by. This parameter has been replaced with new filters (release_bundle_version, created_by, release_status, tag) and will be deprecated in a future version.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "order_by",
            "in": "query",
            "description": "Defines the sort criterion for the Release Bundle versions. Options 'created' (sorts by creation timestamp), 'created_by' (sorts by creator name), 'release_bundle_name' (sorts by name), 'release_bundle_version' (sorts lexicographically), 'release_bundle_semver' (sorts using SemVer rules; versions that do not conform to SemVer are added to the end sorted lexicographically), 'promotion_created' (sorts by the latest promotion timestamp; versions that were never promoted are always ordered last, regardless of the sort direction). Note The release_bundle_semver option pulls the latest 1000 records only and does not support pagination. When this option is selected, the offset must be set to 0, and the maximum limit is 1000.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "created",
                "created_by",
                "release_bundle_name",
                "release_bundle_version",
                "release_bundle_semver",
                "promotion_created"
              ],
              "default": "created"
            }
          },
          {
            "name": "order_asc",
            "in": "query",
            "description": "Defines the sort order. true for ascending order, false for descending order. The default value is false.",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Sets the number of records to skip for pagination.",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Sets the maximum number of versions to return at one time. Used for pagination purposes. The default value is 25. The maximum value is 255.",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 255,
              "default": 25
            }
          },
          {
            "name": "tag",
            "in": "query",
            "description": "Filters by the assigned Release Bundle tag. Supports a trailing wildcard (*) and multiple comma-separated values.",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^[\\w\\-.*,]*$"
            }
          },
          {
            "name": "release_status",
            "in": "query",
            "description": "Filters by the release status of the Release Bundle. Supports a single value or multiple comma-separated values (e.g. RELEASED,TRUSTED_RELEASE), which are combined with OR. Values are case-insensitive and surrounding whitespace is ignored. Possible values are PRE_RELEASE, RELEASED and TRUSTED_RELEASE.",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^\\s*(PRE_RELEASE|RELEASED|TRUSTED_RELEASE)\\s*(,\\s*(PRE_RELEASE|RELEASED|TRUSTED_RELEASE)\\s*){0,2}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Submitted (asynchronous) - The request was successful.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetBundlesResponse"
                },
                "examples": {
                  "versions_list": {
                    "summary": "List of bundle versions",
                    "value": {
                      "release_bundles": [
                        {
                          "status": "COMPLETED",
                          "repository_key": "release-bundles-v2",
                          "release_bundle_name": "my-bundle",
                          "release_bundle_version": "1.0.0",
                          "service_id": "jfrt@01h0nvs1pwjtzs15x7kbtv1sve",
                          "created_by": "admin",
                          "created": "2025-04-29T14:17:21.587Z"
                        }
                      ],
                      "total": 1,
                      "limit": 25,
                      "offset": 0
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Bad Credentials - The provided authentication is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Permission Denied - The user does not have the necessary permissions to perform this action.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found - The specified Release Bundle name does not exist.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "GetBundlesResponse": {
        "type": "object",
        "properties": {
          "release_bundles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BundleVersionSummary"
            }
          },
          "total": {
            "type": "integer",
            "description": "Total number of results."
          },
          "limit": {
            "type": "integer",
            "description": "The number of results returned in this page."
          },
          "offset": {
            "type": "integer",
            "description": "The offset for the current page of results."
          },
          "next_offset": {
            "type": "integer",
            "description": "The offset for the next page of results. A value of -1 indicates there are no more pages."
          }
        }
      },
      "BundleVersionSummary": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "description": "Status of the bundle version (STARTED, FAILED, COMPLETED, DELETING)"
          },
          "repository_key": {
            "type": "string",
            "description": "Repository key where the bundle is stored"
          },
          "release_bundle_name": {
            "type": "string",
            "description": "Name of the release bundle"
          },
          "release_bundle_version": {
            "type": "string",
            "description": "Version of the release bundle"
          },
          "release_bundle_status": {
            "type": "string",
            "description": "Release bundle status"
          },
          "service_id": {
            "type": "string",
            "description": "The unique identifier of the Artifactory instance where the Release Bundle version was created"
          },
          "created_by": {
            "type": "string",
            "description": "The name of the user who created the Release Bundle. Names longer than 64 characters will appear truncated."
          },
          "created": {
            "type": "string",
            "description": "Timestamp when the new version was created (ISO 8601 format)"
          },
          "tag": {
            "type": "string",
            "description": "The descriptive tag assigned to the Release Bundle version, if any"
          },
          "release_status": {
            "type": "string",
            "description": "Indicates whether the Release Bundle has been promoted successfully to the official release stage (PROD), making it available for consumption. Possible values are pre_release and released. Requires release 7.120.1 or above."
          },
          "current_environment": {
            "type": "string",
            "description": "Indicates the most recent environment (for example, QA, Staging) to which the Release Bundle version was promoted successfully. If the version has not yet been promoted, this value will be an empty string. Requires release 7.120.1 or above."
          },
          "current_stage": {
            "type": "string",
            "description": "Current stage"
          },
          "current_promotion_created": {
            "type": "string",
            "description": "Timestamp of current promotion creation"
          },
          "messages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EventMessage"
            },
            "description": "Error messages related to the processing of the operation (only included if not empty)"
          },
          "permissions": {
            "$ref": "#/components/schemas/BundlePermissions",
            "description": "Whether the user has permission to promote, distribute, and delete these Release Bundle versions (only included if not null)"
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "description": "Standard error body for non-2xx responses (400, 401, 403, 404, 500). Matches Artifactory-style error format.",
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ErrorItem"
            },
            "description": "List of error entries"
          }
        }
      },
      "ErrorItem": {
        "type": "object",
        "description": "A single error entry in an error response.",
        "properties": {
          "status": {
            "type": "integer",
            "description": "HTTP status code (e.g. 400, 401, 403, 404, 500)"
          },
          "message": {
            "type": "string",
            "description": "Human-readable error message"
          }
        }
      },
      "EventMessage": {
        "type": "object",
        "description": "Event message",
        "properties": {
          "text": {
            "type": "string",
            "description": "Message text"
          }
        }
      },
      "BundlePermissions": {
        "type": "object",
        "description": "Permissions for a bundle",
        "properties": {
          "create": {
            "type": "boolean",
            "description": "Permission to create"
          },
          "promote": {
            "type": "boolean",
            "description": "Permission to promote"
          },
          "distribute": {
            "type": "boolean",
            "description": "Permission to distribute"
          },
          "delete": {
            "type": "boolean",
            "description": "Permission to delete"
          },
          "annotate": {
            "type": "boolean",
            "description": "Permission to annotate"
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "JWT token authentication"
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```