# TROLIE Seasonal API

**Canonical:** https://apis.io/apis/trolie/trolie-seasonal-api/  
**Provider:** TROLIE — https://apis.io/providers/trolie/  
**Base URL:** https://trolie.example.com  
**Documentation:** https://trolie.energy/spec-1.0

TROLIE Seasonal API is one of 6 APIs that [TROLIE](https://apis.io/providers/trolie/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Seasonal. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Seasonal ratings are static ratings associated with extended durations, typically months. These are typically used in both planning and operations. Power system resources that are exempt from providing AARs generally operate at a seasonal rating. Even for resources using dynamic ratings, a seasonal rating is still necessary. This acts as a recourse when a dynamic rating is unavailable. For example, a dynamic rating might be unavailable during communication outages or for forecasts beyond the ten-day period required by FERC Order 881.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/seasonal-ratings/snapshot` | Get Seasonal Ratings |
| GET | `/rating-proposals/seasonal` | Obtain seasonal rating proposal status |
| PATCH | `/rating-proposals/seasonal` | Submit a Seasonal Ratings proposal |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/trolie/refs/heads/main/openapi/trolie-seasonal-api-openapi.yml
- **Documentation** — https://trolie.energy/spec-1.0
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/trolie/refs/heads/main/json-schema/trolie-forecast-proposal-status-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/trolie/refs/heads/main/json-schema/trolie-real-time-proposal-status-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/trolie/refs/heads/main/json-schema/trolie-seasonal-ratings-proposal-status-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/trolie/refs/heads/main/json-schema/trolie-realtime-proposal-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/trolie/refs/heads/main/json-schema/trolie-forecast-limits-snapshot-slim-inputs-used-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/trolie/refs/heads/main/json-schema/trolie-realtime-limits-snapshot-slim-inputs-used-schema.json

## Other TROLIE APIs (5)

- [TROLIE Forecasting API](https://apis.io/apis/trolie/trolie-forecasting-api/)
- [TROLIE Monitoring Sets API](https://apis.io/apis/trolie/trolie-monitoring-sets-api/)
- [TROLIE Seasonal Overrides API](https://apis.io/apis/trolie/trolie-seasonal-overrides-api/)
- [TROLIE Temporary AAR Exceptions API](https://apis.io/apis/trolie/trolie-temporary-aar-exceptions-api/)
- [TROLIE Realtime API](https://apis.io/apis/trolie/trolie-realtime-api/)

## Tags

Seasonal

---

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