Contrails API

Version: v0.22.0

Contrails API is a RESTful interface to the open source pycontrails library. It provides all of the basic functionality of pycontrails in a web service with automatic weather data retrieval and pre-computed contrail forecasts.

See the Get Started notebook for a comprehensive introduction and the API Reference for a complete list of endpoints and parameters.

Research API

The Research API endpoints (v0) are hosted at https://api.contrails.org/v0.

At present, the Research API includes endpoints for calculating model outputs on a specific flight trajectories and meteorology grids.

These endpoints are subject to unannounced updates and potentially backward incompatible changes.

See the Research API Reference for more details.

Production API (beta)

The Production API endpoints (v1) are hosted at https://api.contrails.org/v1.

At present, the Production API includes endpoints for retrieving global contrail forecasts at standard flight levels, as well as geojson polygon regions at various contrail impact thresholds.

These endpoints are intended for use in flight planning and other production integrations.

See the Production API Reference for more details.

References