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

# Get Release Bundle V2 Distribution Details

Returns the details of a specific distribution of a Release Bundle v2 version.

**Security:** Requires permissions to distribute Release Bundles.

# 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 Distribution",
      "description": "Release bundle distribution operations. Note These endpoints represent the external JFrog Distribution API as documented in the official REST API documentation. The internal BundleRelease Bundle V2 Distribution.java implements different endpoints for transaction management (transaction/open, transaction/close)."
    }
  ],
  "paths": {
    "/distribution/trackers/{release_bundle_name}/{release_bundle_version}/{distribution_id}": {
      "get": {
        "tags": [
          "Release Bundle V2 Distribution"
        ],
        "summary": "Get Release Bundle V2 Distribution Details",
        "description": "Returns the details of a specific distribution of a Release Bundle v2 version.\n\n**Security:** Requires permissions to distribute Release Bundles.",
        "x-since": "7.63.2",
        "operationId": "getDistributionDetails",
        "parameters": [
          {
            "name": "release_bundle_name",
            "in": "path",
            "description": "Release bundle name",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^\\w[\\w\\-.]*$",
              "minLength": 1
            }
          },
          {
            "name": "release_bundle_version",
            "in": "path",
            "description": "Release bundle version",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^\\w[\\w\\-.+]*$",
              "minLength": 1
            }
          },
          {
            "name": "distribution_id",
            "in": "path",
            "description": "Distribution ID",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "project",
            "in": "query",
            "description": "The project key used to determine the Release Bundles repository",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "repository_key",
            "in": "query",
            "description": "The Release Bundles repository identifier",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success - Successfully retrieved distribution details",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DistributionDetailsResponse"
                },
                "examples": {
                  "distribution_details": {
                    "summary": "Distribution details with site info",
                    "value": {
                      "distribution_id": 12345,
                      "distribution_friendly_id": 1,
                      "type": "distribute",
                      "release_bundle_name": "my-bundle",
                      "release_bundle_version": "1.0.0",
                      "status": "COMPLETED",
                      "distributed_by": "admin",
                      "start_time": "2025-04-29T14:17:21.587Z",
                      "finish_time": "2025-04-29T14:20:00.000Z",
                      "duration": 158413
                    }
                  }
                }
              }
            }
          },
          "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 distribution does not exist.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "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"
          }
        }
      },
      "DistributionRule": {
        "type": "object",
        "properties": {
          "site_name": {
            "type": "string",
            "description": "Defines a wildcard filter for a site name. The default value is *."
          },
          "city_name": {
            "type": "string",
            "description": "Defines a wildcard filter for a city name. The default value is *."
          },
          "country_codes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Defines one or more filters for country codes. The default value is [*]."
          }
        }
      },
      "DistributionTarget": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of Edge node serving as the destination target"
          },
          "service_id": {
            "type": "string",
            "description": "The unique identifier of the Artifactory instance where the Release Bundle was distributed"
          },
          "type": {
            "type": "string",
            "description": "The destination target device type (e.g. Artifactory)"
          }
        }
      },
      "DistributionDetailsResponse": {
        "type": "object",
        "properties": {
          "distribution_id": {
            "type": "integer",
            "format": "int64",
            "description": "The ID number of the distribution operation"
          },
          "distribution_friendly_id": {
            "type": "integer",
            "description": "The sequential distribution number of this Release Bundle version"
          },
          "type": {
            "type": "string",
            "description": "Indicates whether this action was a distribution request or a remote delete request"
          },
          "release_bundle_name": {
            "type": "string",
            "description": "Name of the Release Bundle"
          },
          "release_bundle_version": {
            "type": "string",
            "description": "Release Bundle version"
          },
          "status": {
            "type": "string",
            "description": "The current status of the Release Bundle"
          },
          "distributed_by": {
            "type": "string",
            "description": "The user who initiated distribution"
          },
          "start_time": {
            "type": "string",
            "description": "Timestamp when distribution of the Release Bundle version started"
          },
          "finish_time": {
            "type": "string",
            "description": "Timestamp when distribution of the Release Bundle version finished"
          },
          "duration": {
            "type": "integer",
            "description": "The duration of the distribution from start to finish (in ms)"
          },
          "distribution_rules": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DistributionRule"
            },
            "description": "Defines which distribution targets were included in this distribution"
          },
          "sites": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DistributionSiteDetails"
            },
            "description": "Provides the details of the distribution operation to each designated target"
          }
        }
      },
      "DistributionSiteDetails": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "description": "Status of the distribution to this site"
          },
          "target_artifactory": {
            "$ref": "#/components/schemas/DistributionTarget",
            "description": "The target Artifactory instance"
          },
          "total_files": {
            "type": "integer",
            "description": "Total number of files to distribute"
          },
          "total_bytes": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of bytes to distribute"
          },
          "distributed_files": {
            "type": "integer",
            "description": "Number of files successfully distributed"
          },
          "distributed_bytes": {
            "type": "integer",
            "format": "int64",
            "description": "Number of bytes successfully distributed"
          },
          "distributed_by": {
            "type": "string",
            "description": "User who initiated the distribution"
          },
          "start_time": {
            "type": "string",
            "description": "Timestamp when distribution to this site started"
          },
          "finish_time": {
            "type": "string",
            "description": "Timestamp when distribution to this site finished"
          },
          "file_errors": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "List of file errors encountered during distribution"
          },
          "files_in_progress": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "List of files currently being distributed"
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "JWT token authentication"
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```