List impacted machines with alert summary (level 1) | NVIDIA Fleet Intelligence Documentation

{
  "distinctComputeZoneCount": 2,
  "distinctGpuTypeCount": 3,
  "distinctNodeGroupCount": 4,
  "hasMore": false,
  "nodes": [
    {
      "nodeUuid": "node-uuid-456",
      "agentStatus": {
        "inband": {
          "lastSeenAt": "2026-09-15T20:30:00Z",
          "status": "online"
        },
        "oob": {
          "lastSeenAt": "2026-09-15T20:30:00Z",
          "status": "online"
        }
      },
      "bmcHostname": "bmc-a.example.com",
      "computeZone": "Compute Zone Name",
      "criticalCount": 4,
      "gpuType": "NVIDIA-H100-80GB-HBM3",
      "hostStatus": "Active",
      "hostname": "gpu-node-01",
      "lastAlertTime": "2024-12-01T10:00:00Z",
      "nodeGroup": "Node Group Name 1",
      "nodeName": "machine-001",
      "resolvedCount": 0,
      "warningCount": 2
    }
  ],
  "page": 0,
  "pageSize": 50,
  "total": 25,
  "totalCritical": 14,
  "totalResolved": 0,
  "totalWarning": 35
}

Returns a paginated list of nodes with per-node alert counts and inventory metadata for the Alerts panel. GPU type uses the node’s resolved value independently of alert source. Use active=true for the Active Alerts view (only nodes with currently active alerts) or active=false for Historical Alerts. Cross-page aggregates (totalCritical, totalWarning, distinctGpuTypeCount, etc.) reflect the full filtered result set and drive table header counts. componentVisibility is resolved server-side from the user’s auth persona and is not an HTTP parameter.

Query parameters

activebooleanOptionalDefaults to false

Active Alerts view when true; Historical Alerts when false (default: false)

pageintegerOptionalDefaults to 0

Page number (0-indexed)

pageSizeintegerOptionalDefaults to 50

Number of nodes per page

nameSearchstringOptional

Case-insensitive substring matched against the in-band hostname, OOB machine name, BMC hostname, and node UUID

inbandAgentStatuseslist of enumsOptional

In-band agent machine status (online, offline, not_enrolled). Repeated values are ORed.

Allowed values:

oobAgentStatuseslist of enumsOptional

OOB collector machine status (online, offline, not_enrolled). Repeated values are ORed; this filter is ANDed with inbandAgentStatuses.

Allowed values:

sortByenumOptionalDefaults to alert

Sortable table-header column. nodeName and bmcHostname sort OOB identities; nodeUUID sorts the Machine ID column; alert ranks by critical then warning count. Missing names sort last.

orderenumOptionalDefaults to desc

Sort direction for sortBy

Allowed values:

gpuTypeslist of stringsOptional

Filter to nodes with matching resolved GPU types (OR within dimension)

nodeGroupIdslist of stringsOptional

Filter to nodes in matching node groups by node group ID (OR within dimension)

computeZoneIdslist of stringsOptional

Filter to nodes in matching compute zones by compute zone ID (OR within dimension)

alertStateslist of enumsOptional

Filter to nodes with at least one alert whose state matches (OR within dimension). Resolved applies to the Historical view only (active=false).

Allowed values:

dataSourceslist of enumsOptional

Filter alerts by producing data source (inband or oob). Repeated values are ORed; omitted means both sources. Counts and pagination reflect matching alerts.

Allowed values:

componentTypeslist of stringsOptional

Filter to nodes with alerts on matching component types. Use the value ‘psirt’ to match all security-vulnerability CVEs (the collapsed ‘Security Vulnerability’ option).

Response

List of nodes with alert summary

distinctComputeZoneCountintegerOptional

Distinct compute zones among matching nodes

distinctGpuTypeCountintegerOptional

Distinct GPU types among matching nodes

distinctNodeGroupCountintegerOptional

Distinct node groups among matching nodes

hasMorebooleanOptional

nodeslist of objectsOptional

pageintegerOptional

pageSizeintegerOptional

totalintegerOptional

Total number of nodes matching filters across all pages

totalCriticalintegerOptional

Cross-page critical alert total; drives ALERT header

totalResolvedintegerOptional

Cross-page resolved alert total; historical view only

totalWarningintegerOptional

Cross-page warning alert total

Errors

400

Bad Request Error

401

Unauthorized Error

499

Client Closed Request Error

500

Internal Server Error