Sign in

v57

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-08-012143051018.3 KB
SKU

Retrieve all SKUs

Retrieve all SKUs (Stock Keeping Units) for a Site.

SKUs represent unique hardware configurations discovered at sites. They are automatically derived from machine characteristics.

A siteId query parameter is required for all requests.

For Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with PROVIDER_ADMIN suffix.

For Tenants: Org must have a Tenant with TargetedInstanceCreation capability enabled and Tenant Account with Machine's Provider. User must have authorization role with TENANT_ADMIN suffix.

get/v2/org/{org}/nico/sku

Query parameters

siteIdstring uuid required

ID of the Site to retrieve SKUs from

pageNumberinteger
Example:1

Page number for pagination query

pageSizeinteger
Example:20

Page size for pagination query

orderBy'CREATED_ASC' | 'CREATED_DESC' | 'UPDATED_ASC' | 'UPDATED_DESC' | 'ID_ASC' | 'ID_DESC'

Ordering for pagination query

Response

OK

idstring

Unique identifier for the SKU

siteIdstring uuid

ID of the Site this SKU belongs to

descriptionstring

Human-readable SKU description

schemaVersioninteger

Core SKU schema version when available

deviceTypestring nullable

Optional device type identifier (e.g. "gpu", "cpu", "storage")

associatedMachineIdsstring[]

List of machine IDs associated with this SKU

createdstring date-time

ISO 8601 datetime when the SKU was created

updatedstring date-time

ISO 8601 datetime when the SKU was last updated

Example response

[
  {
    "id": "lenovo.sr650v2.cpu.1",
    "siteId": "60189e9c-7d12-438c-b9ca-6998d9c364b1",
    "description": "Lenovo SR650 V2 compute node",
    "schemaVersion": 5,
    "deviceType": "gpu",
    "associatedMachineIds": [
      "fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g"
    ],
    "components": {
      "cpus": [
        {
          "vendor": "Intel",
          "model": "Xeon Platinum 8480+",
          "threadCount": 112,
          "count": 2
        }
      ],
      "gpus": [
        {
          "vendor": "NVIDIA",
          "model": "H100 SXM5",
          "totalMemory": "80GB HBM3",
          "count": 8
        }
      ],
      "memory": [
        {
          "capacityMb": 65536,
          "memoryType": "DDR5",
          "count": 16
        }
      ],
      "storage": [
        {
          "vendor": "Samsung",
          "model": "PM9A3",
          "capacityMb": 7680000,
          "count": 4
        }
      ],
      "chassis": {
        "vendor": "Supermicro",
        "model": "SYS-420GP-TNR"
      }
    },
    "created": "2019-08-24T14:15:22Z",
    "updated": "2019-08-24T14:15:22Z"
  }
]