{
    "version": "https://jsonfeed.org/version/1",
    "title": "Heimdall Power API Changelog",
    "home_page_url": "https://developer.heimdallcloud.com/changelog",
    "description": "Stay up to date with changes to the Heimdall Power External API",
    "items": [
        {
            "id": "https://developer.heimdallcloud.com/changelog/2026/05/18/assets-expose-facility-voltages",
            "content_html": "<p>The <code>GET /assets/v1/assets</code> response now includes <code>nominal_voltage</code> (always present) and\n<code>operational_voltage</code> (optional) on each facility. Both are phase-to-phase voltages in volts.\nThese values feed the apparent-power calculation on the capacity-monitoring circuit-rating\nendpoint.</p>",
            "url": "https://developer.heimdallcloud.com/changelog/2026/05/18/assets-expose-facility-voltages",
            "title": "Facility voltages now included in asset response",
            "summary": "The GET /assets/v1/assets response now includes nominal_voltage (always present) and",
            "date_modified": "2026-05-18T00:00:00.000Z",
            "tags": [
                "assets",
                "v1",
                "added"
            ]
        },
        {
            "id": "https://developer.heimdallcloud.com/changelog/2026/05/18/capacity-monitoring-add-apparent-power-metric",
            "content_html": "<p><code>GET /capacity_monitoring/v1/facilities/{facility_id}/circuit_ratings/latest</code> now accepts an\noptional <code>metric</code> query parameter. Use <code>metric=current</code> (default) to receive the rating in\namperes, or <code>metric=apparent_power</code> to receive it in MVA, computed as\n<code>S = sqrt(3) * V * I / 1,000,000</code>. The line's operational voltage is used when configured and\npositive; otherwise the nominal voltage is used. Both voltages are exposed on the facility in the\n<code>GET /assets/v1/assets</code> response so you can verify which value the calculation used.</p>",
            "url": "https://developer.heimdallcloud.com/changelog/2026/05/18/capacity-monitoring-add-apparent-power-metric",
            "title": "Circuit rating can now be returned as apparent power",
            "summary": "GET /capacitymonitoring/v1/facilities//circuit_ratings/latest now accepts an",
            "date_modified": "2026-05-18T00:00:00.000Z",
            "tags": [
                "capacity-monitoring",
                "v1",
                "added"
            ]
        },
        {
            "id": "https://developer.heimdallcloud.com/changelog/2026/05/12/capacity-monitoring-add-circuit-ratings-endpoint",
            "content_html": "<p>Added <code>GET /capacity_monitoring/v1/facilities/{facility_id}/circuit_ratings</code>, which\nreturns a time series of circuit ratings for a facility over a requested period.\nUse this endpoint to retrieve historical circuit rating data rather than just the\nlatest value.</p>",
            "url": "https://developer.heimdallcloud.com/changelog/2026/05/12/capacity-monitoring-add-circuit-ratings-endpoint",
            "title": "Historical circuit ratings endpoint added",
            "summary": "Added GET /capacitymonitoring/v1/facilities//circuit_ratings, which",
            "date_modified": "2026-05-12T00:00:00.000Z",
            "tags": [
                "capacity-monitoring",
                "v1",
                "added"
            ]
        },
        {
            "id": "https://developer.heimdallcloud.com/changelog/2026/05/12/grid-insights-add-conductor-temperatures-endpoint",
            "content_html": "<p>Added <code>GET /grid_insights/v1/lines/{line_id}/conductor_temperatures</code>, which returns\na time series of conductor temperature measurements for a line over a requested\nperiod. Use this endpoint to retrieve historical conductor temperature data rather\nthan just the latest value.</p>",
            "url": "https://developer.heimdallcloud.com/changelog/2026/05/12/grid-insights-add-conductor-temperatures-endpoint",
            "title": "Historical conductor temperatures endpoint added",
            "summary": "Added GET /gridinsights/v1/lines//conductor_temperatures, which returns",
            "date_modified": "2026-05-12T00:00:00.000Z",
            "tags": [
                "grid-insights",
                "v1",
                "added"
            ]
        },
        {
            "id": "https://developer.heimdallcloud.com/changelog/2026/05/05/capacity-monitoring-add-at-span-id-to-dlr",
            "content_html": "<p>The <code>GET /capacity_monitoring/v1/lines/{line_id}/heimdall_dlrs/latest</code> response now includes\n<code>at_span_id</code>, a UUID identifying the specific span on the line where the lowest ampacity was\ncalculated. This lets you pinpoint which part of the line is the limiting factor for the\ncurrent DLR value.</p>",
            "url": "https://developer.heimdallcloud.com/changelog/2026/05/05/capacity-monitoring-add-at-span-id-to-dlr",
            "title": "DLR response now includes the span with lowest ampacity",
            "summary": "The GET /capacitymonitoring/v1/lines//heimdall_dlrs/latest response now includes",
            "date_modified": "2026-05-05T00:00:00.000Z",
            "tags": [
                "capacity-monitoring",
                "v1",
                "added"
            ]
        },
        {
            "id": "https://developer.heimdallcloud.com/changelog/2026/04/29/assets-expose-facility-components",
            "content_html": "<p>The <code>GET /assets/v1/assets</code> response now includes facility components. This allows grid owners to map facility component IDs to component names.</p>",
            "url": "https://developer.heimdallcloud.com/changelog/2026/04/29/assets-expose-facility-components",
            "title": "Facility components now included in asset response",
            "summary": "The GET /assets/v1/assets response now includes facility components. This allows grid owners to map facility component IDs to component names.",
            "date_modified": "2026-04-29T00:00:00.000Z",
            "tags": [
                "assets",
                "v1",
                "added"
            ]
        },
        {
            "id": "https://developer.heimdallcloud.com/changelog/2026/04/29/grid-insights-add-line-currents-endpoint",
            "content_html": "<p>Added <code>GET /grid_insights/v1/lines/{line_id}/currents</code>, which returns a time series\nof current measurements for a line over a requested period. Use this endpoint to\nretrieve historical current data rather than just the latest value.</p>",
            "url": "https://developer.heimdallcloud.com/changelog/2026/04/29/grid-insights-add-line-currents-endpoint",
            "title": "Historical line currents endpoint added",
            "summary": "Added GET /gridinsights/v1/lines//currents, which returns a time series",
            "date_modified": "2026-04-29T00:00:00.000Z",
            "tags": [
                "grid-insights",
                "v1",
                "added"
            ]
        },
        {
            "id": "https://developer.heimdallcloud.com/changelog/2026/04/23/capacity-monitoring-add-is-fallback-to-dlr",
            "content_html": "<p>The <code>GET /capacity_monitoring/v1/lines/{line_id}/heimdall_dlrs/latest</code> response now\nincludes an <code>is_fallback</code> field. When <code>true</code>, the DLR value is a fallback rather than\na live calculation — this applies to grid owners who have opted in to the fallback\nfeature. Integrations that display or act on DLR values should account for this flag.</p>",
            "url": "https://developer.heimdallcloud.com/changelog/2026/04/23/capacity-monitoring-add-is-fallback-to-dlr",
            "title": "DLR response now indicates fallback values",
            "summary": "The GET /capacitymonitoring/v1/lines//heimdall_dlrs/latest response now",
            "date_modified": "2026-04-23T00:00:00.000Z",
            "tags": [
                "capacity-monitoring",
                "v1",
                "added"
            ]
        },
        {
            "id": "https://developer.heimdallcloud.com/changelog/2026/04/16/grid-insights-add-extremum-values-to-sag",
            "content_html": "<p>The <code>GET /grid_insights/v1/lines/{line_id}/sag_and_clearance/latest</code> response now\nincludes line-level <code>max_sag</code> and <code>min_clearance</code> values for the current\naggregation window, together with per-span sag and clearance details. This makes it\neasier to identify the highest sag and lowest clearance on a line without polling\nrepeatedly.</p>",
            "url": "https://developer.heimdallcloud.com/changelog/2026/04/16/grid-insights-add-extremum-values-to-sag",
            "title": "Sag and clearance response includes extremum values",
            "summary": "The GET /gridinsights/v1/lines//sagandclearance/latest response now",
            "date_modified": "2026-04-16T00:00:00.000Z",
            "tags": [
                "grid-insights",
                "v1",
                "added"
            ]
        }
    ]
}