How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Southwest Power Pool Seasonal API

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

Southwest Power Pool Seasonal API is one of 11 APIs that Southwest Power Pool publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Seasonal. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 3 operations across 2 paths, and defines 52 schemas. It is described by OpenAPI 3.2.0, at version 1.1.0.

Requests are made against a single base URL, https://trolie.example.com.

3 operations 2 paths 52 schemas 2 GET1 PATCH

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.1.0
Base URL
ftp://pubftp.spp.org
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Southwest Power Pool Seasonal API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2-primary-flow) using the clientCredentials flow, exposing 15 scopes. By default, every request must be authenticated.

  • oauth2-primary-flow — Support RFC8725 JWT tokens.

Paths & Operations 3

Across 2 paths, the API surfaces 3 operations — 2 GET, 1 PATCH. Each is listed below with its method, path, parameters, and response codes.

Seasonal 3

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…

GET
/seasonal-ratings/snapshot
Get Seasonal Ratings
getSeasonalRatingsSnapshot 2 params → 200304400401403404406429
GET
/rating-proposals/seasonal
Obtain seasonal rating proposal status
getSeasonalRatingProposalStatus → 200304400401403406429500
PATCH
/rating-proposals/seasonal
Submit a Seasonal Ratings proposal
patchSeasonalRatingsProposal body → 202400401403406409413415

Schemas 52

The contract defines 52 schemas that model the data the API accepts and returns. The most detailed are seasonal-proposal-considered (11 properties), seasonal-proposal (9 properties), seasonal-snapshot-detailed (8 properties), seasonal-snapshot (7 properties). Each schema is shown below with its type and property counts.

missing-seasonal-obligation
object
4 properties
base-header
object
3 properties 2 required
seasonal-rating-snapshot-item-detailed
object
2 properties
undervoltage-threshold
object
A lower limit to voltage for a transmission facility in kilovolts.
1 property 1 required
input
object
3 properties 2 required
named-power-system-resources
array
Collection of power system resource names
active-power-with-power-factor
object
3 properties 2 required
seasonal-proposal-slim
array
seasonal-rating-snapshot-item
object
2 properties
problem
object
See [RFC9457](https://www.rfc-editor.org/rfc/rfc9457appendix-A).
5 properties 1 required
data-provenance
object
Provides information about where the associated representation came from. No functional aspects of the exchange are contingent upon this data. However, this in…
3 properties 2 required
ratings
array
Set of forecast limits
active-power
object
2 properties 1 required
empty
stringnull
Intended to proactively avoid information disclosure
limit-value-set
array
A set of general limit or rating values, each mapped to the various limit bands defined by the Transmission Provider's operating manual. This typically consist…
limiting-analysis
string
Indicates how a operating limit was determined. This is used to provide context for the ratings proposals and limits snapshots. When defined in the header, thi…
name-type
string
Type of the name being referenced. Corresponds to the IEC CIM NameType concept.
emergency-durations
array
Defines the durations in minutes used for emergency limits.
local
string
Contains a identifier that is unique for an object in the context of an exchange between two grid operators.
seasonal-ratings-snapshot-detailed-elide-psr
object
A snapshot of the seasonal ratings for a monitoring set.
2 properties 2 required
overvoltage-threshold-pu
object
An upper limit to voltage for a transmission facility in per unit with the base voltage assumed to be the nominal voltage.
1 property 1 required
ordered-named-power-system-resources
array
Ordered array of power system resource names. The order of these items determines the order of the ratings proposals in the ratings array.
undervoltage-threshold-pu
object
An lower limit to voltage for a transmission facility in per unit with the nominal voltage assumed to be the base voltage.
1 property 1 required
seasonal-snapshot-detailed
object
Proposes the continuous and emergency ratings for the specified Season.
8 properties 5 required
seasonal-proposal-considered
object
Proposes the continuous and emergency ratings for the specified Season.
11 properties 2 required
resource-id
string
Contains a unique identifier for a power system resource, such as a transmission facility, segment, interface, etc. This identifier is typically used between r…
limit
object
Defines the limit. In practice most exchanges will only support one kind of limit for proposals and snapshots. However, the specification supports defining lim…
quality-class-current-source
string
This property is modeled after the Quality Class called "Current Source" in ICCP. It is used to indicate the source of the current value of the proposed rating…
day-night
string
Optional label to specify if the proposed seasonal ratings schedule is meant to be used only during the day or only a night. If this field is not provided, the…
current
object
Representation of a thermal limit in amperes.
1 property 1 required
seasonal-proposal-header
object
Describes the contents of this seasonal ratings proposal.
4 properties 3 required
seasonal-proposals
object
2 properties
seasonal-ratings-snapshot-detailed
object
A snapshot of the seasonal ratings for a monitoring set.
2 properties 2 required
seasonal-snapshot
object
Proposes the continuous and emergency ratings for the specified Season.
7 properties 4 required
period-start
string
RFC 3339 date-time string with no fractional seconds component that designates a start or end to an operating period (such as an hour) that starts at a specifi…
seasonal-ratings-proposal-slim
object
2 properties 2 required
apparent-power
object
2 properties 1 required
seasonal-ratings-proposal-status
object
Seasonal rating proposal status
5 properties 3 required
seasonal-proposals-slim
array
A proposal for the seasonal ratings for a power system object, e.g., a segment. The proposal's structure is determined by the contents of the proposal-header.…
timestamp
string
RFC 3339 date-time string with a maximum of 10 digits in the fractional seconds component, i.e., nanosecond precision.
season-name
string
A name for the season
reactive-power
object
Representation of a limit in megavolt-amperes reactive (MVAR).
1 property 1 required
seasonal-schedule
array
Defines the seasonal ratings schedule adopted in this proposal. Each season is given a season-name with the beginning of the season starting on begins and endi…
common-header
object
4 properties 3 required
seasonal-proposal-header-slim
object
Describes the contents of the seasonal proposal. In particular, the structure of the ratings is determined by the details provided in this header.
5 properties 4 required
overvoltage-threshold
object
An upper limit to voltage for a transmission facility in kilovolts.
1 property 1 required
names
object
2 properties 1 required
seasonal-ratings-proposal
object
2 properties 2 required
seasonal-proposal
object
Proposes the continuous and emergency ratings for the specified Season.
9 properties 4 required
seasonal-ratings-snapshot
object
A snapshot of the seasonal ratings for a monitoring set.
2 properties 2 required
entity
string
Contains a unique identifier for an entity, such as a grid operator or organization. This identifier is typically used in the context of data exchange between…
season
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

spp-seasonal-api-openapi.yml Raw ↑

Other APIs Southwest Power Pool publishes across the network.

SPP Public Data FTP
SPP Portal Public Data File Browser API
SPP Portal Chart API
SPP Price Contour Map ArcGIS REST Services
SPP Integrated Marketplace Markets Web Service
Southwest Power Pool Forecasting API
Southwest Power Pool Monitoring Sets API
Southwest Power Pool Real Time API
Southwest Power Pool Seasonal Overrides API
Southwest Power Pool Temporary AAR Exceptions API
Where this information came from

This is an independent, third-party profile of Southwest Power Pool Seasonal API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.