--- title: "Retrieve all Explored Endpoints" method: GET path: "/v2/org/{org}/nico/site-explorer/endpoint" tags: ["Site Explorer"] --- # Retrieve all Explored Endpoints `GET /v2/org/{org}/nico/site-explorer/endpoint` Retrieve explored endpoints discovered by Site Explorer for a Site. Use `ID_ASC` or `ID_DESC` to order by endpoint ID; the default is `ID_ASC`. The response is paged over Core `FindExploredEndpointIds` followed by `FindExploredEndpointsByIds`. Pagination metadata is returned in the `X-Pagination` response header. User must have authorization role with `PROVIDER_ADMIN` suffix. ## Query parameters - `siteId` string, uuid, required - `pageNumber` integer — One-indexed page number. - `pageSize` integer - `orderBy` 'ID_ASC' | 'ID_DESC' ## Response `200` Explored endpoints for the Site - ExploredEndpoint[] - `address` string, required — BMC IP address used as the explored endpoint ID. - `report` EndpointExplorationReport — Data gathered about an endpoint during site exploration. - `endpointType` string, required — Type of the explored endpoint. - `lastExplorationError` string, nullable — Last exploration error serialized as JSON, when present. - `machineId` string, uuid, nullable — Machine ID derived for the endpoint when available. - `lastExplorationLatency` string, nullable — Go duration string for the last exploration latency (for example `1.5s`). - `vendor` string, nullable — Vendor reported by Redfish. - `managers` ExploredManager[] - `id` string, required - `ethernetInterfaces` ExploredEthernetInterface[] - `id` string, nullable - `description` string, nullable - `interfaceEnabled` boolean, nullable - `macAddress` string, nullable - `linkStatus` string, nullable - `systems` ExploredComputerSystem[] - `id` string, required - `manufacturer` string, nullable - `model` string, nullable - `serialNumber` string, nullable - `attributes` ExploredComputerSystemAttributes — ComputerSystem attributes from Redfish. - `nicMode` 'Dpu' | 'Nic' | 'Unknown' | 'null', nullable - `ethernetInterfaces` ExploredEthernetInterface[] - `id` string, nullable - `description` string, nullable - `interfaceEnabled` boolean, nullable - `macAddress` string, nullable - `linkStatus` string, nullable - `pcieDevices` ExploredPCIeDevice[] - `description` string, nullable - `firmwareVersion` string, nullable - `gpuVendor` string, nullable - `id` string, nullable - `manufacturer` string, nullable - `name` string, nullable - `partNumber` string, nullable - `serialNumber` string, nullable - `status` ExploredSystemStatus — Redfish health and state status. - `health` string, nullable - `healthRollup` string, nullable - `state` string, required - `powerState` 'On' | 'Off' | 'PoweringOff' | 'PoweringOn' | 'Paused' | 'Unknown' | 'Hibernating' | 'Sleeping', required - `bootOrder` ExploredBootOrder — Redfish boot order list. - `bootOrder` ExploredBootOption[] - `displayName` string, required - `id` string, required - `bootOptionEnabled` boolean, nullable - `uefiDevicePath` string, nullable - `chassis` ExploredChassis[] - `id` string, required - `networkAdapters` ExploredNetworkAdapter[] - `id` string, required - `manufacturer` string, nullable - `model` string, nullable - `partNumber` string, nullable - `serialNumber` string, nullable - `manufacturer` string, nullable - `model` string, nullable - `partNumber` string, nullable - `serialNumber` string, nullable - `service` ExploredService[] - `id` string, required - `inventories` ExploredInventory[] - `id` string, required - `description` string, nullable - `version` string, nullable - `releaseDate` string, nullable - `machineSetupStatus` ExploredMachineSetupStatus — Result of a Redfish machine-setup check. - `isDone` boolean, required - `diffs` ExploredMachineSetupDiff[] - `key` string, required - `expected` string, required - `actual` string, required - `evaluatedBootInterface` ExploredMachineBootInterfaceTarget — Boot-interface target assessed during exploration. - `pair` ExploredMachineBootInterfacePair — MAC and Redfish EthernetInterface.Id pair. - `macAddress` string, required - `interfaceId` string, required - `macOnly` string, nullable - `secureBootStatus` ExploredSecureBootStatus — Redfish secure-boot status. - `isEnabled` boolean, required - `lockdownStatus` ExploredLockdownStatus — Redfish lockdown status. - `status` 'Enabled' | 'Partial' | 'Disabled' | 'Unknown', required - `message` string, required - `firmwareVersions` object — Parsed firmware component versions keyed by component name. - `lastExplorationErrorSchema` OperatorErrorSchema — Structured exploration error for operator tooling. - `errorCode` string, required — Stable identifier for alerting and log filtering. - `mitigation` string, nullable — Suggested operator action when known. - `text` string, required — Human-readable problem description. - `reportVersion` string, required — Version of the exploration report; increases when the report is updated. - `explorationRequested` boolean, required — Whether the endpoint will be explored in the next Site Explorer run. - `preingestionState` string, required — Current preingestion state for the endpoint. - `lastRedfishBmcReset` string, required — Last BMC Redfish reset time. - `lastIpmitoolBmcReset` string, required — Last BMC IPMI tool reset time. - `lastRedfishReboot` string, required — Last BMC Redfish reboot time. - `lastRedfishPowercycle` string, required — Last BMC Redfish power-cycle time. - `pauseRemediation` boolean, required — When true, Site Explorer will not take remediation actions for Redfish errors. ## Other responses - `400` — Response when the API handler encounters an unexpected error - `403` — Error response when user is not authorized to call an endpoint or retrieve/modify objects - `404` — Response when the API handler encounters an unexpected error - `412` — Response when the API handler encounters an unexpected error - `500` — Response when the API handler encounters an unexpected error - `504` — Response when the API handler encounters an unexpected error ## Changes - **2026-08-18** `c459c6587dee` — 4 warning - for the `query` request parameter `pageNumber`, the max was set to `21474836.00` - for the `query` request parameter `pageSize`, the max was set to `100.00` - for the `query` request parameter `pageNumber`, the min was set to `1.00` - for the `query` request parameter `pageSize`, the min was set to `1.00` - **2026-08-14** `edf558021ee2` — 2 warning - added the new `Hibernating` enum value to the `items/report/systems/items/powerState` response property for the response status `200` - added the new `Sleeping` enum value to the `items/report/systems/items/powerState` response property for the response status `200` - **2026-08-11** `00108ce07fd5` — 1 info - endpoint added [Change history](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/changes/v2/org/:org/nico/site-explorer/endpoint/get.md) --- [API](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api.md) · [All operations](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nvidia/nvidia-infra-controller-rest-api/revisions/a2dc05bef3c1/schema)