8. Changelog

8.1. Online Docs Release Notes

All notable changes to this documentation page will be documented in this file.

A Date-Based Versioning is adopted for the documentation, with a prefix ‘D’ designator for Docs, e.g., ‘DYYYY.MM.DD.micro’ (Based on versioning convention on https://calver.org/).

Note: This is NOT the same as the ODS JSON Schema version (as listed in ODS Data Format), nor the internal version tracking of the NRAO’s ODS API server itself.

[Releases Version] - Release Date

[D2026.01.13.0] - 2026-01-13

Added

Description of “Zone Avoidance” in Operational Data Sharing (ODS) v1.0.0
site_id description in ODS Adoption
Description for how the frequency range is being reported for each receiver in “Current NRAO/GBO facility adoption status” in ODS Adoption
Table for ODS use cases currently supported at each NRAO/GBO facilities in ODS Adoption
A list of satellite constellations that have coordination agreement with NSF and using ODS API in ODS Adoption Sec.
A list of related software tools developped by the ODS community in ODS Adoption
A new How to interface with the NRAO ODS API Sec. with subsections: Authentication, Uploading TLE Data, Example Python Script
Update Relevant Publications to include IEEE article citation, RFI memos, student reports, relevant FCC NPRM & US131, along with relevant publications & articles with URLs
Update Changelog to include version history for ODS API server and ODS JSON (formerly under ODS Data Format) in Changelog

Changed

Updated ODS status table for NRAO facilities

Move “Current NRAO/GBO facility adoption status” into ODS Adoption and move that up after ODS Use Cases

Updated information in Helpdesk

[D2025.11.12.0] - 2025-11-12

Added

Support for TLE ingestion endpoint & documentation in Uploading TLE Data
Description for subarray field in ‘Single dish and arrays’ subsection in ODS Use Cases
Changelog section
A sentence for TBA not meant for UEMR in Operational Data Sharing (ODS) v1.0.0
Two new references for the NSF coordination agreements with Amazon and AST SpaceMobile in Relevant Publications

Changed

Reordered the ‘Atmospheric refraction’ subsection in ODS Use Cases

[D2025.10.29.0]- 2025-10-29

Added

Initial public release of this documentation page (https://obs.vla.nrao.edu/ods)

8.2. ODS API Version History

This list only shows changes that affect the external clients.

API version	Change descriptions
2025.11.19.0	GET /ods_data returns only active mitigation requests or mitigation requests starting in the next thirty minutes.
2025.11.12.0	Support added for satellite operators to upload Two-Line Element (TLE) files to the ODS API
2025.10.13.0	Added the legal language to the automatically generated docs
2025.9.22.0	`trk_rate*` fields will return `0` if no value supplied by the Data Sender
2025.7.17.2	Initial launch on 18 Jul 2025 for JSON schema v.1.0.0

8.3. JSON Schema Change History

JSON Schema version

Removed

Added

Query return example

v1.0.0

(18 Jul 2025 - present)

src_is_pulsar_bool (boolean)
src_radius (float)
notes (string)

dish_diameter_m (float)
subarray (integer)
version (string)

{"ods_data": [
  {"corr_integ_time_sec": 3.0,
     "dish_diameter_m": 25.0,
     "freq_lower_hz": 1000000000.0,
     "freq_upper_hz": 2000000000.0,
     "site_el_m": 2124.0,
     "site_id": "vla_B",
     "site_lat_deg": 34.07874917,
     "site_lon_deg": -107.6177275,
     "slew_sec": 238.7,
     "src_dec_j2000_deg": 49.8520093222222,
     "src_end_utc": "2025-10-26T06:24:55.344695",
     "src_id": "0542+498=3C147",
     "src_ra_j2000_deg": 85.65057465,
     "src_start_utc": "2025-10-26T06:20:55.999986",
     "subarray": 0,
     "trk_rate_dec_deg_per_sec": 0.0,
     "trk_rate_ra_deg_per_sec": 0.0,
     "version": "1.0.0"} ]}

v.helloworld.1

(Aug 2023 - 18 Jul 2025)
Still supported by SpaceX as of Jan 2026

N/A

{"ods_data": [
  {"corr_integ_time_sec": 3,
     "freq_lower_hz": 26000000000,
     "freq_upper_hz": 40000000000,
     "site_el_m": 2124,
     "site_id": "vla_D",
     "site_lat_deg": 34.07874917,
     "site_lon_deg": -107.6177275,
     "slew_sec": 130.8,
     "src_dec_j2000_deg": 3.15681115,
     "src_end_utc": "2023-08-16T15:26:16.000723",
     "src_id": "J1056+7011",
     "src_is_pulsar_bool": false,
     "src_ra_j2000_deg":  126.459743145833,
     "src_radius": 0,
     "src_start_utc": "2023-08-16T15:23:47.000541",
     "trk_rate_dec_deg_per_sec": 0,
     "trk_rate_ra_deg_per_sec": 0} ]}