Stations

The station list is a persistent registry of FM stations discovered through band scans. Stations are added automatically when a scan is performed on any tuner. Each station record captures the frequency and signal quality at the time of discovery and can be used to configure a tuner directly.

---

GET /stations/all

Returns all currently discovered stations.

Roles: user, admin

Response: Array of Station objects.

[
  {
    "station_id": 0,
    "frequency": 88100,
    "rssi": 54,
    "snr": 31,
    "timestamp": "2025-03-14T10:22:05Z"
  },
  {
    "station_id": 1,
    "frequency": 93500,
    "rssi": 71,
    "snr": 42,
    "timestamp": "2025-03-14T10:22:07Z"
  }
]

---

GET /station/{station_id}

Returns a single station record by its ID.

Roles: user, admin

Path parameters:

Parameter	Type	Description
station_id	integer ≥ 0	Station record ID assigned at scan time

Response: Single Station object.

---

DELETE /station/{station_id}

Removes a station record from the discovered stations list. Does not affect any tuner currently monitoring that frequency.

Roles: user, admin

Path parameters:

Parameter	Type	Description
station_id	integer ≥ 0	Station record ID to delete

---

DELETE /stations/all

Removes all discovered station records. This clears the global station list but does not affect tuner configurations.

Roles: user, admin

Warning

This operation cannot be undone. Station records are repopulated the next time a band scan is performed on any tuner.

---

Station Object

Field	Type	Description
station_id	integer	Unique record ID, assigned sequentially at scan time
frequency	integer (kHz)	Station frequency, e.g. 93500 for 93.5 MHz
rssi	integer	Signal strength measured during the scan
snr	integer	Signal-to-noise ratio measured during the scan
timestamp	string	ISO 8601 datetime when the station was discovered