---
title: "Retrieve GPU stats for machines at a site"
method: GET
path: "/v2/org/{org}/nico/machine/gpu/stats"
tags: ["Machine"]
---

# Retrieve GPU stats for machines at a site

`GET /v2/org/{org}/nico/machine/gpu/stats`

Returns GPU summary stats grouped by GPU name for machines at the specified site.

User must have authorization role with `PROVIDER_ADMIN` suffix. The specified site must belong to the Provider.

## Query parameters

- `siteId` string, uuid, required

## Response `200`

OK

- MachineGPUStats[]
  - `name` string — GPU name from the MachineCapability record
  - `gpus` integer — Total number of GPUs (summation of all Machine GPU capability counts)
  - `machines` integer — Number of machines that have this GPU capability

## Other responses

- `403` — Error response when user is not authorized to call an endpoint or retrieve/modify objects

---

[API](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api.md) · [All operations](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nvidia/nvidia-infra-controller-rest-api/revisions/2096eb1db2c1/schema)