Novant

Documentation

Search /
Sign in

Explorer Sources

Retrieves the list of sources discovered in this project. Each entry describes a source found during a scan, along with any device metadata reported by the source.

GET /v1/explorer/sources
curl https://api.novant.io/v1/explorer/sources \
  -u ak_sample_123: \
  --compressed

Returns

Returns the list of discovered sources in this project.

{
  "sources": [
    {
      "id": "c1578fe370e4",
      "name": "ECB-600-3",
      "type": "bacnet",
      "addr": "10.0.1.3:47808",
      "device_id": 102,
      "path": null,
      "vendor": "ACME",
      "model": "AHU-B15",
      "version": "2.07",
      "firmware": "1.0.12",
      "desc": "AHU-3",
      "last_scan": "2026-07-13T22:02:18.193Z",
      "last_learn": null,
      "point_count": null
    },
    {
      "id": "e1ca7fadc524",
      "name": "ECB-VAV-01",
      "type": "bacnet",
      "addr": "10.0.2.1:47808",
      "device_id": 200,
      "path": null,
      "vendor": "ACME",
      "model": "VAV-HX1",
      "version": "1.25",
      "firmware": "1.3.40",
      "desc": "VAV-01",
      "last_scan": "2026-07-13T22:02:18.193Z",
      "last_learn": null,
      "point_count": null
    },
    ...
  ]
}

The id field is the discovery id for the source — pass it to Explorer Points to list the points the source advertises. This id is distinct from the s.<n> id assigned when a source is bound into the project.

The device metadata fields — device_id, path, vendor, model, version, firmware, and desc — are populated from data reported by the source and may be null when the source does not advertise them.

last_scan and last_learn are ISO 8601 timestamps, or null when the step has not run. A scan discovers the source on the network; a learn reads its point list. point_count is populated once the source has been learned, and is null until then.