# Southwest Power Pool Temporary AAR Exceptions API

**Canonical:** https://apis.io/apis/spp/spp-temporary-aar-exceptions-api/  
**Provider:** Southwest Power Pool — https://apis.io/providers/spp/  
**Base URL:** ftp://pubftp.spp.org  
**Documentation:** https://spp.org/documents/28853/spp%20public%20data%20access%2020230707.pdf

Southwest Power Pool Temporary AAR Exceptions API is one of 11 APIs that [Southwest Power Pool](https://apis.io/providers/spp/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Temporary AAR Exceptions. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

A [Temporary AAR Exception](https://trolie.energy/concepts#temporary-aar-exception) is provided by the Ratings Provider when a Ratings Obligation cannot be fulfilled, due to some temporary operating condition impacting the related power system resource. This could occur in various scenarios: * An equipment failure. * An unforeseen condition on a related part of the power grid. * Some ambient condition that is not part of the model is heating the line, like a wildfire. * Something in the surrounding environment is affecting the amount that a line is allowed to sag. For example, this may occur for lines over rivers when very large ships pass under them A Temporary AAR Exception serves two main purposes: documenting the reason for the exception and providing a temporary rating value set. It is employed in three distinct circumstances: 1. Firstly, Order 881 mandates documentation and archival of all use of alternate ratings in lieu of AARs. Ratings Providers should continue to provide real-time and forecast ratings for the affected resource, but these should match the rating provided with the Temporary AAR Exception while the latter is in effect. This temporary rating, and the reason that it occurred, must be captured in history regardless of the provided ratings. The reason and the end date of the effective window may be updated after the object has been created, up to a configurable threshold. If the Ratings Providers provides ratings that deviate from the static Temporary AAR Exception rating, the Clearinghouse Provider must decide whether to use those or the static rating. The Clearinghouse Provider advise its Ratings Providers on how it will choose ahead of time. This specification recommends using the dynamic rating provided, but it does not mandate it. 2. Secondly, Temporary AAR Exceptions apply when the Clearinghouse Provider is generating forecast rating proposals on behalf of the Ratings Provider, e.g., when lookup tables are provided ahead of time by the Ratings Provider. Since there is no external ratings, the Clearinghouse Provider wouldn't otherwise know that a temporary static rating is needed. 3. Finally, for facilities where dynamic ratings are provided, it is possible that a communications outage or other issue could prevent the Clearinghouse Provider from receiving the dynamic ratings. In this case, the Clearinghouse Provider would use a Temporary AAR Exception rating.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/temporary-aar-exceptions` | Temporary AAR Exceptions |
| POST | `/temporary-aar-exceptions` | Create a new temporary AAR Exception |
| GET | `/temporary-aar-exceptions/{id}` | Obtain a specific temporary AAR exception by Id. |
| DELETE | `/temporary-aar-exceptions/{id}` | Delete a specific temporary AAR Exception by Id. |
| PUT | `/temporary-aar-exceptions/{id}` | Updates an existing Temporary AAR Exception. |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/spp/refs/heads/main/openapi/spp-temporary-aar-exceptions-api-openapi.yml
- **Documentation** — https://www.spp.org/documents/72496/spp%20lep%20api%20data%20exchange%20guide.pdf
- **Specification** — https://trolie.energy/spec

## Other Southwest Power Pool APIs (10)

- [SPP Public Data FTP](https://apis.io/apis/spp/spp-public-data-ftp/)
- [SPP Portal Public Data File Browser API](https://apis.io/apis/spp/spp-portal-file-browser-api/)
- [SPP Portal Chart API](https://apis.io/apis/spp/spp-portal-chart-api/)
- [SPP Price Contour Map ArcGIS REST Services](https://apis.io/apis/spp/spp-price-contour-map-arcgis/)
- [SPP Integrated Marketplace Markets Web Service](https://apis.io/apis/spp/spp-integrated-marketplace-web-services/)
- [Southwest Power Pool Forecasting API](https://apis.io/apis/spp/spp-forecasting-api/)
- [Southwest Power Pool Monitoring Sets API](https://apis.io/apis/spp/spp-monitoring-sets-api/)
- [Southwest Power Pool Real Time API](https://apis.io/apis/spp/spp-real-time-api/)
- [Southwest Power Pool Seasonal API](https://apis.io/apis/spp/spp-seasonal-api/)
- [Southwest Power Pool Seasonal Overrides API](https://apis.io/apis/spp/spp-seasonal-overrides-api/)

## Tags

Temporary AAR Exceptions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/spp/spp-temporary-aar-exceptions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/spp/.