Forecasting API Stable


The specification of the Forecasting operations in TROLIE OpenAPI specification is now considered stable, closing the associated milestone. Specifically, no further changes are anticipated to the media type schemas and resource semantics–the HTTP verbs, paths, and status codes–for submitting forecasts and retrieving forecast snapshots. We are naming this release 1.0.0-wip-forecasting-stable to reflect that fact that the specification is still under development, but we believe the forecasting operations effectively address the use cases that have been identified over the last several months.

Stable Use Cases

Implementors should consider the specification stable in its support of the following use cases:

  • Submitting Forecast Ratings Proposals
  • Obtaining Forecast Ratings Proposal Status
  • Obtaining Forecast Limits Snapshots, including:
    • “Slim” snapshots that provide just the determined limits
    • Detailed snapshots that provide all of the inputs used by the Clearinghouse Provider to determine the limits, including all proposals and overrides.

Improved and Expanded Documentation

We continue to improve the documentation at In preparation for this release, we have:

Looking Ahead

The next milestone will stabilize Real-Time Ratings Proposals. Future milestones will include handling temporary AAR exceptions, seasonal ratings, and defining the peering profile which will specify how TROLIE implementations will integrate using only some simple configuration.

The specification will be updated accordingly without a version change until the next milestone is completed, remaining at 1.0.0-wip-forecasting-stable even as the Real-Time Ratings Proposals milestone is completed. However, any necessary changes to the forecasting operations will result in a version change and another announcement.