This page provides an overview for the SMA API catalogue

Swagger documentation

To make your life easier to start developing against our APIs, we have implemented Swaggers as our API-endpoint and DataModel documentation tool. This allows you to explore and test the API right in your browser with our included test client.

SMA Monitoring API

View OpenAPI/Swagger description

  • Ensures the reliable operation of energy generation assets
  • Provides system core-, log/event- and granular measurement data of plants & connected devices from Sunny Portal and ennexOS Portal

  • O&M, Energy Trading, VPPs
  • End-users (e.g. Energy, SmartHome) Apps

  • Custom Flow
  • Code Grant Flow

Available in Production & Sandbox

Available in Production & Sandbox

SMA GridControl API

View OpenAPI/Swagger description

  • Enables high re-activity, adaptivity of SMA assets to fast changing market conditions and to avoid FeedIn penalties
  • Provides remote-steering of PV-generation assets and allows clients to change SMA system settings and operations modes via schedule commands

  • O&M, Energy Trading, VPPs

  • Custom Flow
  • Code Grant Flow

Available in Production & Sandbox

Available in Production & Sandbox

SMA GeoForecast API

View Online Swagger provided in Jan22

  • Optimize trading margins or inform end-users using precise, constantly updated PV- generation forecasts.
  • Provides reliable AI-powered, constantly calibrated PV-generation & weather forecasts based on geolocation and system data (OEM system-agnostic).
  • Basic and Pro-Edition available.

  • O&M, Energy Trading, VPPs
  • End-users (e.g. Energy, SmartHome) Apps

  • Client Grant Flow

Available in Production (SBX in Jan22)

Available in Production (SBX in Jan22)

SMA Live API

View Online Swagger provided in Jan22

  • Enhance your clients user experience by offering “live” UI-views of PV-generation & consumption data
  • Provides nearTime measurement data (EnergyBalance) for SMA WebConnect systems of plants from Sunny Portal and ennexOS Portal
  • Not allowed for constant monitoring

  • End-users (e.g. Energy, SmartHome) Apps

  • Custom Flow
  • Code Grant Flow

Available in Production (SBX in Jan22)

Available in Production (SBX in Jan22)

SMA SmartHome API

View Online Swagger provided in Jan22

  • Empowers your users to control energy consumers in their households
  • Provides remote-steering of smart devices (e.g. PowerPlug connected, SEMP and EV-chargers) in SMA systems to set/change supported operational modes

  • End-users (e.g. Energy, SmartHome) Apps

  • Custom Flow
  • Code Grant Flow

Available in Production (SBX in Jan22)

Available in Production (SBX in Jan22)

SMA Spot

On request integration

  • Reduce your customer & asset acquisition cost
  • Provides an embedded, digital UX-solution for Energy Trading contracts to on-board SMA customers & systems in relevant context situations on SMA Sunny Design & further SMA touchpoints

  • O&M, Energy Trading, VPPs

  • Context-specific permission flow

  • On request: Revenue-share based on system/contract-value
Available in Production

Available in Production