> ## 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 with additional details

> Returns recommendation details for container manifests in the specified cluster with additional fields.
This endpoint includes all base fields plus: predictedUptime, configLastChangedOn, nodeGroup,
oomKills_last7days, dateFirstAudited, and dateLastAudited.
Fields with no value may be omitted from the response.


## Overview

This endpoint returns container recommendation details for a specific cluster with **additional fields** when `details=true` is included.

For the base response format without additional details, see [getKubernetesClusterContainers](/docs-api/WebHelp_Densify_API_Cloud/Content/API_Guide/Kubernetes_Clusters_Results/getKubernetesClusterContainers).

## Additional Fields with details=true

When you include `details=true` in the query parameters, the following additional fields are included in each container recommendation:

<Accordion title="Additional Fields Reference">
  | Field                 | Type               | Description                                                   |
  | --------------------- | ------------------ | ------------------------------------------------------------- |
  | `predictedUptime`     | number (float)     | Predicted uptime percentage for the container                 |
  | `configLastChangedOn` | string (date-time) | Timestamp of the most recent change to requests/limits        |
  | `nodeGroup`           | array of strings   | Names of associated node groups                               |
  | `oomKills_last7days`  | integer            | Number of OOM (Out Of Memory) events in the last 7 days       |
  | `dateFirstAudited`    | string (date-time) | When this container was first audited (from workload history) |
  | `dateLastAudited`     | string (date-time) | When this container was last audited (from workload history)  |
</Accordion>

## Example Request

```bash theme={null}
curl -X GET "https://api.example.com/api/v2/kubernetes/clusters/my-cluster/containers?details=true" \
  -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,
    
    // Additional fields when details=true
    "predictedUptime": 99.8,
    "configLastChangedOn": "2026-05-15T14:20:00Z",
    "nodeGroup": ["node-group-1", "node-group-2"],
    "oomKills_last7days": 2,
    "dateFirstAudited": "2026-01-10T08:00:00Z",
    "dateLastAudited": "2026-06-08T10:30:00Z"
  }
]
```

## Use Cases

The detailed fields are particularly useful for:

* **Stability Monitoring**: `oomKills_last7days` helps identify containers experiencing memory pressure
* **Change Tracking**: `configLastChangedOn` shows when resource configurations were last modified
* **Historical Analysis**: `dateFirstAudited` and `dateLastAudited` provide audit timeline context
* **Infrastructure Planning**: `nodeGroup` information helps with placement and scaling decisions
* **Reliability Metrics**: `predictedUptime` aids in understanding container availability patterns

<Note>
  Fields without values may be omitted from the response. All timestamps are in UTC format (`YYYY-MM-DDTHH:mm:ssZ`).
</Note>


## OpenAPI

````yaml openapi/kubernetes/kubernetes_clusters_results.yaml GET /kubernetes/clusters/{clusterName}/containers?details=true
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?details=true:
    get:
      tags:
        - Kubernetes Cluster Results
      summary: List container recommendations with additional details
      description: >
        Returns recommendation details for container manifests in the specified
        cluster with additional fields.

        This endpoint includes all base fields plus: predictedUptime,
        configLastChangedOn, nodeGroup,

        oomKills_last7days, dateFirstAudited, and dateLastAudited.

        Fields with no value may be omitted from the response.
      operationId: getKubernetesClusterContainersDetailed
      parameters:
        - $ref: '#/components/parameters/k8s_clusterName'
        - name: details
          in: query
          required: true
          description: Must be set to true to get additional fields
          schema:
            type: boolean
            enum:
              - true
      responses:
        '200':
          description: Array of container recommendations with additional details
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ContainerRecommendationDetailed'
        '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:
    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
    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).
  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

````