This page provides an overview for the SMA API catalogue

SMA APIs

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 Jun22)

SMA Live API

View OpenAPI/Swagger description

  • 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 & Sandbox

SMA SmartHome API

View OpenAPI/Swagger description

  • 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 & Sandbox

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