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-H100-80GB-HBM3",
      "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",
      "lastVerificationCheckTS": "2024-01-15T10:30:00Z",
      "location": {
        "city": "Baltimore",
        "country": "United States",
        "latitude": 39.0458,
        "longitude": -76.6413,
        "region": "us-east-1"
      },
      "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",
      "verificationCheck": "Verified",
      "verificationCheckExtraInfo": {
        "errorDetails": "SDK error: code=13, message=nonce refresh failed",
        "gpuEvidencePresent": true,
        "gpuResults": {},
        "nrasCallResult": "NRAS attestation failed: GPU-0: NONCE_NOT_MATCHING",
        "overallAttestationResult": false
      },
      "verificationCheckReason": "Attestation verification unavailable: SDK error"
    }
  ],
  "page": 0,
  "pageSize": 10,
  "total": 100
}

Get an agent-source-specific inventory report in JSON or CSV format. dataSource=inband preserves the existing GPU/OS inventory shape; dataSource=oob returns the shared report fields plus nodeName, bmcHostname, and bmcIP. GPU type and count come from the selected source. 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). JSON responses include the preferred location and verification-check fields plus the deprecated geoLocation/integrityCheck aliases for backward compatibility.

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.

dataSourceenumOptionalDefaults to inband

Inventory source: inband (default) or oob. The JSON and CSV fields are source-specific.

Allowed values:

agentTypeenumOptionalDeprecated

Deprecated: use dataSource. When both parameters are supplied, their values must match.

Allowed values:

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)

sortByenumOptional

Field to sort by. In-band fields: hostname, publicIP, privateIP. OOB fields: nodeName, bmcHostname, bmcIP. Shared fields: nodeUUID, nodeGroup, computeZone, gpuType, gpuCount, verificationCheck, location. integrityCheck and geoLocation remain deprecated aliases. Defaults to hostname for inband and bmcHostname for oob.

orderenumOptionalDefaults to desc

Sort order (asc, desc)

Allowed values:

Response

OOB JSON response (dataSource=oob). CSV responses use a source-specific header; signed CSV returns application/zip.

models.InbandInventoryReportResponseobject

models.OobInventoryReportResponseobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

499

Client Closed Request Error

500

Internal Server Error

503

Service Unavailable Error