> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/infra-controller/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/infra-controller/_mcp/server.

# Retrieve all Explored Endpoints

GET https://nico-rest-api.nico.svc.cluster.local/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.

Reference: https://docs.nvidia.com/infra-controller/infra-controller/rest-api-reference/api-reference/site-explorer/get-all-site-explorer-endpoint

## Authentication

- `Authorization` header (bearer token, required) — ``` export JWT_BEARER_TOKEN="<jwt-bearer-token>" # Example org name: "acme-inc export ORG_NAME=<org-name> # Use the JWT bearer token in your API request auth header: curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current ```

## Request

### Path parameters

- `org` (string, required) — Name of the Org

### Query parameters

- `siteId` (string, required) — ID of the Site
- `pageNumber` (integer, optional) — Page number of results returned
- `pageSize` (integer, optional) — Number of results per page
- `orderBy` (enum, optional, default: ID_ASC) — Order results by endpoint ID
  - Allowed values: `ID_ASC`, `ID_DESC`

## Response

### 200

Explored endpoints for the Site

- `list of object`
  - `address` (string, required) — BMC IP address used as the explored endpoint ID.
  - `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.
  - `report` (object, optional) — Data gathered about an endpoint during site exploration.
    - `endpointType` (string, required) — Type of the explored endpoint.
    - `lastExplorationError` (string, optional, nullable) — Last exploration error serialized as JSON, when present.
    - `machineId` (string, optional, nullable) — Machine ID derived for the endpoint when available.
    - `lastExplorationLatency` (string, optional, nullable) — Go duration string for the last exploration latency (for example `1.5s`).
    - `vendor` (string, optional, nullable) — Vendor reported by Redfish.
    - `managers` (list of object, optional)
      - `id` (string, required)
      - `ethernetInterfaces` (list of object, optional)
        - `id` (string, optional, nullable)
        - `description` (string, optional, nullable)
        - `interfaceEnabled` (boolean, optional, nullable)
        - `macAddress` (string, optional, nullable)
        - `linkStatus` (string, optional, nullable)
    - `systems` (list of object, optional)
      - `id` (string, required)
      - `powerState` (enum, required)
        - Allowed values: `On`, `Off`, `PoweringOff`, `PoweringOn`, `Paused`, `Unknown`
      - `manufacturer` (string, optional, nullable)
      - `model` (string, optional, nullable)
      - `serialNumber` (string, optional, nullable)
      - `attributes` (object, optional) — ComputerSystem attributes from Redfish.
        - `nicMode` (enum, optional)
          - Allowed values: `Dpu`, `Nic`, `Unknown`
      - `ethernetInterfaces` (list of object, optional)
        - `id` (string, optional, nullable)
        - `description` (string, optional, nullable)
        - `interfaceEnabled` (boolean, optional, nullable)
        - `macAddress` (string, optional, nullable)
        - `linkStatus` (string, optional, nullable)
      - `pcieDevices` (list of object, optional)
        - `description` (string, optional, nullable)
        - `firmwareVersion` (string, optional, nullable)
        - `gpuVendor` (string, optional, nullable)
        - `id` (string, optional, nullable)
        - `manufacturer` (string, optional, nullable)
        - `name` (string, optional, nullable)
        - `partNumber` (string, optional, nullable)
        - `serialNumber` (string, optional, nullable)
        - `status` (object, optional) — Redfish health and state status.
          - `state` (string, required)
          - `health` (string, optional, nullable)
          - `healthRollup` (string, optional, nullable)
      - `bootOrder` (object, optional) — Redfish boot order list.
        - `bootOrder` (list of object, optional)
          - `displayName` (string, required)
          - `id` (string, required)
          - `bootOptionEnabled` (boolean, optional, nullable)
          - `uefiDevicePath` (string, optional, nullable)
    - `chassis` (list of object, optional)
      - `id` (string, required)
      - `networkAdapters` (list of object, optional)
        - `id` (string, required)
        - `manufacturer` (string, optional, nullable)
        - `model` (string, optional, nullable)
        - `partNumber` (string, optional, nullable)
        - `serialNumber` (string, optional, nullable)
      - `manufacturer` (string, optional, nullable)
      - `model` (string, optional, nullable)
      - `partNumber` (string, optional, nullable)
      - `serialNumber` (string, optional, nullable)
    - `service` (list of object, optional)
      - `id` (string, required)
      - `inventories` (list of object, optional)
        - `id` (string, required)
        - `description` (string, optional, nullable)
        - `version` (string, optional, nullable)
        - `releaseDate` (string, optional, nullable)
    - `machineSetupStatus` (object, optional) — Result of a Redfish machine-setup check.
      - `isDone` (boolean, required)
      - `diffs` (list of object, optional)
        - `key` (string, required)
        - `expected` (string, required)
        - `actual` (string, required)
      - `evaluatedBootInterface` (object, optional) — Boot-interface target assessed during exploration.
        - `pair` (object, optional) — MAC and Redfish EthernetInterface.Id pair.
          - `macAddress` (string, required)
          - `interfaceId` (string, required)
        - `macOnly` (string, optional, nullable)
    - `secureBootStatus` (object, optional) — Redfish secure-boot status.
      - `isEnabled` (boolean, required)
    - `lockdownStatus` (object, optional) — Redfish lockdown status.
      - `status` (enum, required)
        - Allowed values: `Enabled`, `Partial`, `Disabled`, `Unknown`
      - `message` (string, required)
    - `firmwareVersions` (map from string to string, optional) — Parsed firmware component versions keyed by component name.
    - `lastExplorationErrorSchema` (object, optional) — Structured exploration error for operator tooling.
      - `errorCode` (string, required) — Stable identifier for alerting and log filtering.
      - `text` (string, required) — Human-readable problem description.
      - `mitigation` (string, optional, nullable) — Suggested operator action when known.

## Examples

**Response**

```json
[
  {
    "address": "string",
    "reportVersion": "string",
    "explorationRequested": true,
    "preingestionState": "string",
    "lastRedfishBmcReset": "string",
    "lastIpmitoolBmcReset": "string",
    "lastRedfishReboot": "string",
    "lastRedfishPowercycle": "string",
    "pauseRemediation": true,
    "report": {
      "endpointType": "string",
      "lastExplorationError": "string",
      "machineId": "string",
      "lastExplorationLatency": "string",
      "vendor": "string",
      "managers": [
        {
          "id": "string",
          "ethernetInterfaces": [
            {
              "id": "string",
              "description": "string",
              "interfaceEnabled": true,
              "macAddress": "string",
              "linkStatus": "string"
            }
          ]
        }
      ],
      "systems": [
        {
          "id": "string",
          "powerState": "On",
          "manufacturer": "string",
          "model": "string",
          "serialNumber": "string",
          "attributes": {
            "nicMode": "Dpu"
          },
          "ethernetInterfaces": [
            {
              "id": "string",
              "description": "string",
              "interfaceEnabled": true,
              "macAddress": "string",
              "linkStatus": "string"
            }
          ],
          "pcieDevices": [
            {
              "description": "string",
              "firmwareVersion": "string",
              "gpuVendor": "string",
              "id": "string",
              "manufacturer": "string",
              "name": "string",
              "partNumber": "string",
              "serialNumber": "string",
              "status": {
                "state": "string",
                "health": "string",
                "healthRollup": "string"
              }
            }
          ],
          "bootOrder": {
            "bootOrder": [
              {
                "displayName": "string",
                "id": "string",
                "bootOptionEnabled": true,
                "uefiDevicePath": "string"
              }
            ]
          }
        }
      ],
      "chassis": [
        {
          "id": "string",
          "networkAdapters": [
            {
              "id": "string",
              "manufacturer": "string",
              "model": "string",
              "partNumber": "string",
              "serialNumber": "string"
            }
          ],
          "manufacturer": "string",
          "model": "string",
          "partNumber": "string",
          "serialNumber": "string"
        }
      ],
      "service": [
        {
          "id": "string",
          "inventories": [
            {
              "id": "string",
              "description": "string",
              "version": "string",
              "releaseDate": "string"
            }
          ]
        }
      ],
      "machineSetupStatus": {
        "isDone": true,
        "diffs": [
          {
            "key": "string",
            "expected": "string",
            "actual": "string"
          }
        ],
        "evaluatedBootInterface": {
          "pair": {
            "macAddress": "string",
            "interfaceId": "string"
          },
          "macOnly": "string"
        }
      },
      "secureBootStatus": {
        "isEnabled": true
      },
      "lockdownStatus": {
        "status": "Enabled",
        "message": "string"
      },
      "firmwareVersions": {},
      "lastExplorationErrorSchema": {
        "errorCode": "string",
        "text": "string",
        "mitigation": "string"
      }
    }
  }
]
```

**SDK Code**

```python
import requests

url = "https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/site-explorer/endpoint"

querystring = {"siteId":"siteId"}

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```javascript
const url = 'https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/site-explorer/endpoint?siteId=siteId';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/site-explorer/endpoint?siteId=siteId"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/site-explorer/endpoint?siteId=siteId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/site-explorer/endpoint?siteId=siteId")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/site-explorer/endpoint?siteId=siteId', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/site-explorer/endpoint?siteId=siteId");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/site-explorer/endpoint?siteId=siteId")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```