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 Overrides API

A Seasonal Override instructs the system to use a temporary static ratinginstead of any concurrent Seasonal Rating for a resource.A typical use case is a so-called 'de-rate' due to a temporary clearanceissue for a transmission facility that is exempt from providing AARs.Exempt facilities typically operate at a seasonal rating. However, insteadof updating the seasonal rating schedule, a Ratings Provider can send aSeasonal Override.During the override period, the Clearinghouse uses the SeasonalOverride rating instead of any scheduled seasonal ratings.For resources required to provide AARs, a Ratings Provider would issue aTemporary AAR Exception to address temporary conditions requiring a staticrating.

Southwest Power Pool Seasonal Overrides 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 Overrides. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 2 paths, and defines 26 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.

5 operations 2 paths 26 schemas 1 DELETE2 GET1 POST1 PUT

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 Overrides 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 5

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

Seasonal Overrides 5

A Seasonal Override instructs the system to use a temporary static rating instead of any concurrent Seasonal Rating for a resource. A typical use case is a so-called 'de-rate' due…

GET
/seasonal-overrides
Get Seasonal Overrides
getSeasonalOverrides 4 params → 200304400401403404406429
POST
/seasonal-overrides
Create a new seasonal override
createSeasonalOverride body → 201400401403404406413415
GET
/seasonal-overrides/{id}
Obtain a specific temporary seasonal rating by Id.
getSeasonalOverride 1 param → 200304400401403404406410
DELETE
/seasonal-overrides/{id}
Delete a specific seasonal override by its Id.
deleteSeasonalOverride 1 param → 204400401403404409429500
PUT
/seasonal-overrides/{id}
Updates an existing Seasonal override
updateSeasonalOverride 1 param body → 204400401403404406413415

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are seasonal-override (9 properties), seasonal-override-request (8 properties), problem (5 properties), active-power-with-power-factor (3 properties). Each schema is shown below with its type and property counts.

undervoltage-threshold
object
A lower limit to voltage for a transmission facility in kilovolts.
1 property 1 required
active-power-with-power-factor
object
3 properties 2 required
problem
object
See [RFC9457](https://www.rfc-editor.org/rfc/rfc9457appendix-A).
5 properties 1 required
seasonal-override-request
object
Data structure for a seasonal override against a resource. Must also include a set of values.
8 properties 4 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
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.
local
string
Contains a identifier that is unique for an object in the context of an exchange between two grid operators.
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
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
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…
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…
seasonal-override
object
Data structure for a seasonal override against a resource. Includes a unique ID, start and (optional) end time, and a reason. Must also include a set of values.
9 properties 5 required
current
object
Representation of a thermal limit in amperes.
1 property 1 required
seasonal-override-set
array
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…
apparent-power
object
2 properties 1 required
timestamp
string
RFC 3339 date-time string with a maximum of 10 digits in the fractional seconds component, i.e., nanosecond precision.
reactive-power
object
Representation of a limit in megavolt-amperes reactive (MVAR).
1 property 1 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
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…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

spp-seasonal-overrides-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 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 Overrides 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.