This page provides release notes for the Contrails API. You can
[subscribe to announcements](https://forms.gle/2GV95u8R2AhE8crb8) to be notified
of upcoming changes.

*** ** * ** ***

## 2026-11-02

- Added `visualizationUrl` to the `/v2/attributions:batchGet` response. It links to an interactive visualization of a flight's contrail attribution on the ContrailWatch page of ContrailExplorer, for the `OBSERVATION` view.

## 2026-08-11

- Started serving flight attributions for 2024 on a best-effort basis (unmaintained). Attribution data from 2025 onwards remains actively maintained and will be updated whenever new detection models or algorithmic improvements are deployed.

## 2026-08-03

- Launched `/v2/attributions:GetAttributionMetrics`. This method gets aggregated contrail attribution metrics by bounds, timestamp, and attribution method.

## 2026-06-30

- Updated `/v2/detections/masks` with a new optional `view` parameter to return satellite disk scantime offsets.

## 2026-06-23

- The `GetDetections` and `GetDetectionMasks` endpoints now support GOES-WEST satellite data.

## 2026-06-08

- Updated `/v2/attributions:batchGet`:
  - Added support for new attribution options using the `view` parameter: `OBSERVATION`, `COCIP`, and the hybrid `OBSERVATION_ENHANCED_COCIP`.
  - Included the Himawari satellite region for satellite-based matching at production-level quality.
  - Added `waypointAttributions` to the response format to yield per-waypoint contrail metrics.
  - Shifted Energy Forcing calculations from static climatological averages to physical radiative forcing derived from gridded CoCiP forecast outputs.

## 2026-05-12

- Launched /v2/detections/masks. This method can retrieve up to an hours' worth of detection masks per request from a specified satellite.

## 2026-04-23

- Aligned API licenses with intended uses. Notably, the forecast API no longer requires ShareAlike.

## 2026-04-08

- Launched /v2/detections. This method gets up to 24 hours of contrail detections per request, and can be filtered to only return contrails from specific satellites.

## 2026-03-30

- Extended the /v2/grids response to support two new data variables:

  - `persistent_formation_probability`: Estimated persistent contrail formation probability
  - `nominal_cocip_effective_energy_forcing`: Estimated effective energy forcing provided by the CoCiP model on the nominal IFS weather forecast (no ensembles)

## 2025-10-24

- Launched /v2/attributions:batchGet to trusted testers. This method gets contrail attributions for all specified flights.

## 2025-08-28

- The /v2/grids attribute `forecast_reference_time` now only changes when the underlying weather forecast has changed, every 6 hours. This makes it easier to detect when the forecast has been updated. The effective forecasting frequency did not change.

## 2025-07-22

- Extended the /v2/grids response to include a data variable attribute `applied_erf_over_rf_ratio` with the applied ERF/RF ratio. For example, the `expected_effective_energy_forcing` uses a ratio of `0.42`. The underlying data did not change.

## 2025-07-16

- Extended /v2/grids to support `?data=expected_effective_energy_forcing` to read the contrail forecast in J/m.

## 2025-03-31

- Launched /v2/grids.
- Launched /v2/regions.
- Deprecated the /v1/ API.