Get finalized XID burst details | NVIDIA Fleet Intelligence Documentation

{
  "agentType": "inband",
  "bmcHostname": "bmc-hostname-1",
  "burstDurationSeconds": 506,
  "burstId": "550e8400-e29b-41d4-a716-446655440000",
  "category": "NVLink",
  "computeZone": "compute-zone-1",
  "computeZoneId": "550e8400-e29b-41d4-a716-446655440000",
  "deviceIds": {},
  "endTime": "2026-07-17T11:33:59Z",
  "hostname": "machine-hostname-1",
  "jobDisruption": true,
  "jobDisruptionDueToPlatformIssue": true,
  "nodeGroup": "node-group-1",
  "nodeGroupId": "550e8400-e29b-41d4-a716-446655440001",
  "nodeName": "machine-name-1",
  "nodeUuid": "624fea4b-0000-0000-0000-0e5737890000",
  "startTime": "2026-07-17T11:25:33Z",
  "stickyXidsSuppressed": 0,
  "subcategory": "NVLink timeout",
  "suggestedActions": [
    {
      "action": "Restart the application",
      "code": "RESTART_APP",
      "persona": "tenant",
      "type": "immediate"
    }
  ],
  "xidCount": 3,
  "xidNumbers": [
    {
      "description": "Graphics Engine Exception",
      "mnemonic": "GR_EXCEPTION",
      "xidNumber": 13
    }
  ]
}

Returns the side-panel details for one finalized burst belonging to the authenticated customer. Response fields are shaped server-side from the caller’s persona. Tenants receive the public job-disruption value, XID numbers with mnemonics, and tenant actions. Cloud-provider/NCP callers additionally receive category, subcategory, platform-attributed disruption, XID catalog descriptions, and all tenant plus DC-admin actions. Suggested action text is resolved from the persona-appropriate Guidance Classes catalog. The response includes nodeUuid, all three node identities (hostname, nodeName, bmcHostname), and the node’s current nodeGroup/computeZone (display names and IDs). This endpoint takes no agentType parameter: burst IDs are unique across observation paths, so one ID resolves without one. The returned agentType field reports which path detected the burst.

Returns the side-panel details for one finalized burst belonging to the authenticated customer. Response fields are shaped server-side from the caller's persona. Tenants receive the public job-disruption value, XID numbers with mnemonics, and tenant actions. Cloud-provider/NCP callers additionally receive category, subcategory, platform-attributed disruption, XID catalog descriptions, and all tenant plus DC-admin actions. Suggested action text is resolved from the persona-appropriate Guidance Classes catalog. The response includes nodeUuid, all three node identities (hostname, nodeName, bmcHostname), and the node's current nodeGroup/computeZone (display names and IDs). This endpoint takes no agentType parameter: burst IDs are unique across observation paths, so one ID resolves without one. The returned agentType field reports which path detected the burst.

Path parameters

burstIdstringRequired

XID burst UUID

Response

agentTypestringOptional

AgentType is the observation path the burst was detected on: “inband” or “oob”. This endpoint takes no agentType parameter — burst IDs are unique across paths — so this field is the only way to tell them apart.

bmcHostnamestringOptional

burstDurationSecondsintegerOptional

burstIdstringOptional

categorystringOptional

Category and Subcategory are cloud-provider/NCP-only fields.

computeZonestringOptional

computeZoneIdstringOptional

deviceIdsmap from strings to lists of integersOptional

DeviceIDs maps each impacted GPU PCI device ID to the distinct XID numbers observed on that device in the burst.

endTimedatetimeOptional

hostnamestringOptional

Hostname, NodeName, and BMCHostname carry the same node-scoped meaning as on XIDBurstListItem.

jobDisruptionbooleanOptional

JobDisruption is true when any XID in the burst is job-fatal. It is identical for tenant and cloud-provider/NCP callers.

jobDisruptionDueToPlatformIssuebooleanOptional

JobDisruptionDueToPlatformIssue is the analyzer’s platform-attributed burst classification and is omitted for tenant callers.

nodeGroupstringOptional

nodeGroupIdstringOptional

nodeNamestringOptional

nodeUuidstringOptional

startTimedatetimeOptional

stickyXidsSuppressedintegerOptional

subcategorystringOptional

suggestedActionslist of objectsOptional

SuggestedActions contains tenant actions for tenants and all tenant plus dc_admin actions for cloud-provider/NCP callers. Action is resolved Guidance Classes text; Code is the catalog action code and Persona identifies the tenant or dc_admin UI section.

xidCountintegerOptional

xidNumberslist of objectsOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

499

Client Closed Request Error

500

Internal Server Error