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 Real Time API

If permitted by the Clearinghouse Provider, its Ratings Providers can usethese functions to exchange real-time ratings, supplementing or replacingtraditional telemetry protocols like ICCP.These ratings are based on real-time measurements of ambient conditionsand will be used by Transmission Providers for real-time grid operationsprocesses, including state estimation and real-time markets. The clearingof real-time ratings may be more frequent than for forecast ratings, butthe frequency is the prerogative of the Clearinghouse Provider.These ratings may be either AARs or DLRs.

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

This API exposes 4 operations across 3 paths, and defines 48 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.

4 operations 3 paths 48 schemas 3 GET1 POST

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 Real Time 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 4

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

Real-Time 4

If permitted by the Clearinghouse Provider, its Ratings Providers can use these functions to exchange real-time ratings, supplementing or replacing traditional telemetry protocols…

GET
/rating-proposals/realtime
Real-Time Proposals Status
getRealTimeProposalStatus → 200304400401403406429500
POST
/rating-proposals/realtime
Submit Real-Time Rating Proposal
postRealTimeProposal body → 202400401403406413415422
GET
/limits/realtime-snapshot
Limits Real Time Snapshot
getRealTimeLimits 2 params → 200304400401403404406429
GET
/limits/regional/realtime-snapshot
Regional Limits Real Time Snapshot
getRegionalRealTimeLimits 2 params → 200304400401403404406429

Schemas 48

The contract defines 48 schemas that model the data the API accepts and returns. The most detailed are operator-override-limit-provenance (8 properties), temporary-aar-exception-provenance (8 properties), real-time-provenance (7 properties), real-time-proposal (6 properties). Each schema is shown below with its type and property counts.

realtime-proposal-slim
object
Used to propose real-time ratings for a set of resources.
3 properties 2 required
undervoltage-threshold
object
A lower limit to voltage for a transmission facility in kilovolts.
1 property 1 required
input
object
3 properties 2 required
real-time-provenance
object
7 properties 4 required
real-time-proposal-slim-header
object
Populated by the Ratings Provider in a request to submit real-time ratings. The Clearinghouse implementation should record this information, and the detail lim…
5 properties 3 required
named-power-system-resources
array
Collection of power system resource names
active-power-with-power-factor
object
3 properties 2 required
realtime-limits-snapshot-slim
object
A slim snapshot of the realtime limits for a monitoring set.
2 properties 2 required
realtime-limits-snapshot
object
A snapshot of the realtime limits for a monitoring set.
2 properties 2 required
problem
object
See [RFC9457](https://www.rfc-editor.org/rfc/rfc9457appendix-A).
5 properties 1 required
real-time-snapshot-header-elide-psr
object
Details about the snapshot provided by the Clearinghouse provider.
3 properties 2 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
real-time-proposal
object
6 properties 3 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.
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.
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
realtime-limits-detailed-snapshot
object
A snapshot of the realtime limits for a monitoring set.
3 properties 3 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…
realtime-limits-detailed-snapshot-elide-psr
object
A snapshot of the realtime limits for a monitoring set.
3 properties 3 required
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…
resource-forecast-inputs
array
realtime-snapshot
object
4 properties 3 required
current
object
Representation of a thermal limit in amperes.
1 property 1 required
unit
string
If the value is dimensionless, this property should not be provided. Since we are not specifying which inputs shall be provided, we cannot specify a definitive…
real-time-proposal-header
object
Populated by the Ratings Provider in a request to submit real-time ratings. The Clearinghouse implementation should record this information, and the detail lim…
4 properties 3 required
real-time-proposal-status
object
Status of the rating provider's real-time obligations. Includes any validation errors encountered while processing proposals.
5 properties 5 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…
temporary-aar-exception-provenance
object
Data structure for a temporary AAR Exception against a resource. Includes a unique ID, start and (optional) end time, and a reason. May or may not include a se…
8 properties 4 required
real-time-snapshot-header
object
Details about the snapshot provided by the Clearinghouse provider.
4 properties 3 required
realtime-snapshot-detailed
object
5 properties 3 required
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
operator-override-limit-provenance
object
Data structure for a temporary AAR Exception against a resource. Includes a unique ID, start and (optional) end time, and a reason. May or may not include a se…
8 properties 4 required
realtime-proposal
object
3 properties 2 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…
realtime-limits-snapshot-slim-inputs-used
object
A slim snapshot of the realtime limits for a monitoring set, including the inputs used to determine the continuous limits.
3 properties 3 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
slim
array
realtime-limits-snapshot-elide-psr
object
A snapshot of the realtime limits for a monitoring set.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

spp-real-time-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 Seasonal 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 Real Time 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.