---
title: "List Nims"
method: GET
path: "/api/v1/nims"
tags: ["nims"]
---

# List Nims

`GET /api/v1/nims`

List all NIM deployments with their status, resource allocation, and pod information.

Returns information about:
- Deployment name and image
- Replica counts (desired, ready, available)
- Resource requests/limits (CPU, memory, GPU)
- Individual pod status and node placement

## Response `200`

Successful Response

- NIMSummary
  - `total_nims` integer, required
  - `running_nims` integer, required
  - `total_gpus_requested` integer, required
  - `nims` NIMInfo[], required
    - `name` string, required
    - `image` string, required
    - `replicas_desired` integer, required
    - `replicas_ready` integer, required
    - `replicas_available` integer, required
    - `port` integer, nullable
    - `resources` ResourceInfo, required
      - `cpu_request` string, nullable
      - `cpu_limit` string, nullable
      - `memory_request` string, nullable
      - `memory_limit` string, nullable
      - `gpu_count` integer, nullable
    - `pods` PodInfo[], required
      - `name` string, required
      - `status` string, required
      - `node` string, nullable
      - `gpu_index` string, nullable
      - `restart_count` integer

---

[API](https://skmtc.net/nebius/apis/nim-metadata-service.md) · [All operations](https://skmtc.net/nebius/apis/nim-metadata-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nebius/nim-metadata-service/revisions/6ed06460dc5e/schema)