> ## Documentation Index > Fetch the complete documentation index at: https://densify-sync-changelog-6.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List container recommendations for a cluster > Returns recommendation details for container manifests in the specified cluster. This endpoint returns the base set of fields. For additional details including uptime predictions, OOM kill counts, and audit history, use the detailed endpoint with details=true. Fields with no value may be omitted from the response. ## Overview This endpoint returns container recommendation details for a specific cluster. This is the **base response format** without additional details. For extended information including uptime predictions, OOM kill counts, node group associations, and audit history, use the detailed endpoint with `details=true`. See [getKubernetesClusterContainersDetailed](/docs-api/WebHelp_Densify_API_Cloud/Content/API_Guide/Kubernetes_Clusters_Results/getKubernetesClusterContainersDetailed) for more information. ## Example Request ```bash theme={null} curl -X GET "https://api.example.com/api/v2/kubernetes/clusters/my-cluster/containers" \ -H "Authorization: Bearer YOUR_API_TOKEN" ``` ## Example Response ```json theme={null} [ { "cluster": "my-cluster", "namespace": "production", "podOwnerName": "web-app", "podOwnerKind": "Deployment", "container": "nginx", "entityId": "abc123", "containerId": "def456", "avgContainerCount": 3, "currentCpuRequestmCores": 500, "currentCpuLimitmCores": 1000, "currentMemRequestBytes": 536870912, "currentMemLimitBytes": 1073741824, "recommendedCpuRequestmCores": 300, "recommendedCpuLimitmCores": 600, "recommendedMemRequestBytes": 268435456, "recommendedMemLimitBytes": 536870912, "estimatedSavingsPerContainer": 45.50, "analyzedOn": "2026-06-08T10:30:00Z", "hpaMetricName": "cpu", "hpaMetricThreshold": "75%", "currentEphemeralStorageRequestBytes": 1073741824, "currentEphemeralStorageLimitBytes": 2147483648, "recommendedEphemeralStorageRequestBytes": 536870912, "recommendedEphemeralStorageLimitBytes": 1073741824 } ] ``` Fields without values may be omitted from the response. All timestamps are in UTC format (`YYYY-MM-DDTHH:mm:ssZ`). ## Need More Details? If you need additional fields such as: * Predicted uptime percentage * Configuration change history * Node group associations * OOM kill events * Audit timeline information Use the [detailed endpoint](/docs-api/WebHelp_Densify_API_Cloud/Content/API_Guide/Kubernetes_Clusters_Results/getKubernetesClusterContainersDetailed) by adding `?details=true` to your request. ## OpenAPI ````yaml openapi/kubernetes/kubernetes_clusters_results.yaml GET /kubernetes/clusters/{clusterName}/containers openapi: 3.0.3 info: title: Kubex API – Kubernetes Clusters Results version: 1.0.0 description: | Container right-sizing recommendations at the cluster level. Returns all analyzed containers in the specified cluster. servers: - url: https://{host}/api/v2 variables: host: default: api.example.com description: Replace with your Kubex API host security: [] tags: - name: Kubernetes Cluster Results description: Container recommendations for a given cluster paths: /kubernetes/clusters/{clusterName}/containers: get: tags: - Kubernetes Cluster Results summary: List container recommendations for a cluster description: > Returns recommendation details for container manifests in the specified cluster. This endpoint returns the base set of fields. For additional details including uptime predictions, OOM kill counts, and audit history, use the detailed endpoint with details=true. Fields with no value may be omitted from the response. operationId: getKubernetesClusterContainers parameters: - $ref: '#/components/parameters/k8s_clusterName' responses: '200': description: Array of container recommendations (base fields) content: application/json: schema: type: array items: oneOf: - $ref: '#/components/schemas/ContainerRecommendation' - $ref: '#/components/schemas/ContainerRecommendationDetailed' description: >- Returns ContainerRecommendation by default, or ContainerRecommendationDetailed when details=true '401': $ref: '#/components/responses/Unauthorized' '404': description: Cluster not found content: application/json: schema: $ref: '#/components/schemas/Error' '500': $ref: '#/components/responses/ServerError' security: - bearerAuth: [] components: parameters: k8s_clusterName: name: clusterName in: path required: true description: >- Unique cluster name from `/kubernetes/clusters` or the Kubex UI Connections tab. schema: type: string schemas: ContainerRecommendation: type: object description: >- Container recommendation entry (base fields). Fields without values may be omitted. properties: cluster: type: string description: Cluster name as specified in the config.yaml files. namespace: type: string description: Namespace associated with the container. podOwnerName: type: string description: Name of the controller or pod owning the container. podOwnerKind: type: string description: >- Controller type (e.g., DaemonSet, Deployment, ReplicaSet, ReplicationController, StatefulSet). container: type: string description: Container manifest name. entityId: type: string description: Unique identifier for the selected cluster assigned by Kubex. containerId: type: string description: Unique identifier for the listed container. avgContainerCount: type: integer description: Average number of containers from the "In Service Instances" metric. currentCpuRequestmCores: type: integer description: Current CPU request (mCores). currentCpuLimitmCores: type: integer description: Current CPU limit (mCores). currentMemRequestBytes: type: integer description: Current memory request (bytes). currentMemLimitBytes: type: integer description: Current memory limit (bytes). recommendedCpuRequestmCores: type: integer description: Recommended CPU request (mCores). recommendedCpuLimitmCores: type: integer description: Recommended CPU limit (mCores). recommendedMemRequestBytes: type: integer description: Recommended memory request (bytes). recommendedMemLimitBytes: type: integer description: Recommended memory limit (bytes). estimatedSavingsPerContainer: type: number format: float description: Estimated savings per container when applying the recommendations. analyzedOn: type: string format: date-time description: Most recent analysis refresh (UTC, `YYYY-MM-DDTHH:mm:ssZ`). hpaMetricName: type: string description: HPA metric name (e.g., cpu, memory). hpaMetricThreshold: type: string description: HPA metric threshold (e.g., 75%). currentEphemeralStorageRequestBytes: type: number description: Current ephemeral storage request (bytes). currentEphemeralStorageLimitBytes: type: number description: Current ephemeral storage limit (bytes). recommendedEphemeralStorageRequestBytes: type: number description: Recommended ephemeral storage request (bytes). recommendedEphemeralStorageLimitBytes: type: number description: Recommended ephemeral storage limit (bytes). gpu: type: object description: GPU-related recommendations and metrics (present for GPU workloads). properties: currentGpuModel: type: string description: Current GPU model. currentGpuSharingStrategy: type: string description: >- Current GPU sharing strategy (e.g., kai-scheduler, time-slicing). currentGpuRequest: type: number format: float description: Current GPU request (fractional GPU units). gpuComputeOptimal: type: number format: float description: Optimal GPU compute utilization. gpuMemoryOptimalBytes: type: number description: Optimal GPU memory usage (bytes). gpuOverallOptimal: type: number format: float description: Overall optimal GPU utilization. recommendedGpuModel: type: string description: Recommended GPU model. recommendedGpuSharingStrategy: type: string description: Recommended GPU sharing strategy. recommendedGpuRequest: type: number format: float description: Recommended GPU request (fractional GPU units). ContainerRecommendationDetailed: allOf: - $ref: '#/components/schemas/ContainerRecommendation' - type: object description: >- Container recommendation entry with additional detail fields (returned when details=true). properties: predictedUptime: type: number format: float description: Predicted uptime percentage for the container. configLastChangedOn: type: string format: date-time description: Timestamp of the most recent change to requests/limits. nodeGroup: type: array items: type: string description: Names of associated node groups. oomKills_last7days: type: integer description: Number of OOM events in the last 7 days. dateFirstAudited: type: string format: date-time description: When this container was first audited (from workload history). dateLastAudited: type: string format: date-time description: When this container was last audited (from workload history). Error: type: object properties: status: type: integer message: type: string responses: Unauthorized: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' ServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````