Get inventory report | NVIDIA Fleet Intelligence Documentation

{
  "hasMore": false,
  "nodes": [
    {
      "agentVersion": "1.2.3",
      "computeZone": "compute-zone-1",
      "enrolledAt": "2024-01-10T08:00:00Z",
      "firmwareCheck": "Passed",
      "geoLocation": {
        "city": "Baltimore",
        "country": "United States",
        "latitude": 39.0458,
        "longitude": -76.6413,
        "region": "us-east-1"
      },
      "gpuCount": 4,
      "gpuDriverVersion": "550.120",
      "gpuFirmwareVersions": [
        {
          "firmwareVersion": "90.17.A9.00.0B",
          "gpuIndex": "0"
        }
      ],
      "gpuType": "NVIDIA-T400-4GB",
      "gpuUUIDs": [
        "GPU-abc-123",
        "GPU-def-456"
      ],
      "hostname": "node-001",
      "integrityCheck": "Verified",
      "integrityCheckExtraInfo": {
        "errorDetails": "SDK error: code=13, message=nonce refresh failed",
        "gpuEvidencePresent": true,
        "gpuResults": {},
        "nrasCallResult": "NRAS attestation failed: GPU-0: NONCE_NOT_MATCHING",
        "overallAttestationResult": false
      },
      "integrityCheckReason": "Attestation verification unavailable: SDK error",
      "kernelVersion": "6.8.0-49-generic",
      "lastIntegrityCheckTS": "2024-01-15T10:30:00Z",
      "nodeGroup": "node-group-1",
      "nodeUUID": "node-123",
      "privateIP": "10.0.0.100",
      "publicIP": "203.0.113.100",
      "removedAt": "2024-01-20T12:00:00Z",
      "serialNumbers": [
        "SN123456789",
        "SN123456790"
      ],
      "systemUUID": "4c4c4544-004a-3410-804c-c7c04f313434"
    }
  ],
  "page": 0,
  "pageSize": 10,
  "total": 100
}

Get inventory report in JSON or CSV format. Default response is JSON. For CSV download, set format=csv. For a signed CSV bundle (CSV plus a cosign-verifiable signature, packaged as a zip), set format=csv and signed=true. Each node includes enrolledAt (original enrollment time, preserved across re-enrollment) and removedAt (soft-delete time for removed nodes, manual and auto-removed alike; absent for active nodes).

Query parameters

pageintegerOptionalDefaults to 0

Page number (0-indexed). Not used for CSV format

pageSizeintegerOptionalDefaults to 10

Page size. Not used for CSV format

formatenumOptionalDefaults to json

Response format (json or csv)

Allowed values:

signedbooleanOptionalDefaults to false

Sign the CSV with NVIDIA’s signing key and return a zip containing the CSV plus a .sig.bundle (cosign-verifiable Sigstore bundle). Only valid with format=csv.

computeZoneIdslist of stringsOptional

Filter by computezone IDs. Empty means all computezones

nodeGroupIdslist of stringsOptional

Filter by nodegroup IDs. Empty means all nodegroups

tagslist of stringsOptional

Filter by tags. Empty means all tags

startTimestringOptional

Start time for filtering nodes active during period (RFC3339 format, e.g., 2024-01-01T00:00:00Z)

endTimestringOptional

End time for filtering nodes active during period (RFC3339 format, e.g., 2024-12-31T23:59:59Z)

sortByenumOptionalDefaults to hostname

Field to sort by

orderenumOptionalDefaults to desc

Sort order (asc, desc)

Allowed values:

Response

JSON response (default). For CSV download, use format=csv query parameter. For signed CSV, use format=csv&signed=true (returns application/zip).

models.InventoryReportResponseobject

string

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

499

Client Closed Request Error

500

Internal Server Error

503

Service Unavailable Error