Novant

Documentation

Search /
Sign in

Explorer Points

Retrieves a single discovered source together with the points it advertises. Use this to inspect a source’s point list before mapping it into the project.

GET /v1/explorer/points
curl -G https://api.novant.io/v1/explorer/points \
  -u ak_sample_123: \
  -d source_id=23a769452950 \
  --compressed

Parameters

source_id Required

The discovery id of the source, i.e.: "23a769452950". This is the id returned by Explorer Sources. Returns a 404 if no discovered source with this id exists.

Returns

Returns the source metadata under source, and the list of advertised points under points.

{
  "source": {
    "id": "23a769452950",
    "name": "ECB-600-1",
    "type": "bacnet",
    "addr": "10.0.1.1:47808",
    "device_id": 100,
    "path": null,
    "vendor": "ACME",
    "model": "AHU-B15",
    "version": "2.07",
    "firmware": "1.0.12",
    "desc": "AHU-1",
    "last_scan": "2026-07-13T22:02:18.193Z",
    "last_learn": "2026-07-13T22:09:47.95Z",
    "point_count": 8
  },
  "points": [
    {
      "name": "Discharge Air Temperature",
      "addr": "ai.1",
      "type": "generic",
      "unit": "°F",
      "enum": null,
      "desc": null,
      "sample": null
    },
    {
      "name": "Discharge Air Pressure",
      "addr": "av.2",
      "type": "generic",
      "unit": "inH₂O",
      "enum": null,
      "desc": null,
      "sample": null
    },
    {
      "name": "Cooling",
      "addr": "av.3",
      "type": "generic",
      "unit": "%",
      "enum": null,
      "desc": null,
      "sample": null
    },
    ...
  ]
}

The source object matches the shape returned by Explorer Sources. The points list reflects the source’s last learn, so it is empty until last_learn is set.