---
title: "Retrieve all Machine Capabilities"
method: GET
path: "/v2/org/{org}/nico/machine-capability"
tags: ["Machine"]
---

# Retrieve all Machine Capabilities

`GET /v2/org/{org}/nico/machine-capability`

Get all distinct Machine Capabilities across all Machines

Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.

## Query parameters

- `siteId` string, required
- `hasInstanceType` boolean
- `type` string
- `name` string
- `frequency` string
- `capacity` string
- `vendor` string
- `inactiveDevices` string
- `count` string
- `pageNumber` integer
- `pageSize` integer
- `orderBy` 'STATUS_ASC' | 'STATUS_DESC' | 'CREATED_ASC' | 'CREATED_DESC' | 'UPDATED_ASC' | 'UPDATED_DESC'

## Response `200`

OK

- MachineCapability[]
  - `type` 'CPU' | 'Memory' | 'Storage' | 'Network' | 'GPU' | 'InfiniBand' | 'DPU' — Type of the Capability
  - `name` string — Name of the Capability component
  - `frequency` string, nullable — Frequency of the Capability component, if available
  - `cores` integer, nullable — Number of Cores in the Capability component, if applicable
  - `threads` integer, nullable — Number of Threads in the Capability component, if applicable
  - `capacity` string, nullable — Capacity of the Capability component, if applicable
  - `vendor` string, nullable — Vendor of the Capability component, if available
  - `hardwareRevision` string, nullable — Hardware revision of the Capability component, if available
  - `inactiveDevices` integer[] — A list of inactive devices
  - `count` integer, nullable — Count of the Capability component
  - `deviceType` string, nullable — Device Type of the Capability component, if available

## Other responses

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

---

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