LOGIN
GET IN TOUCH

Stekker API for Developers

  • By Stekker Support
REST API for smart charging, battery storage (BESS) and market data. Organization-scoped with Bearer token authentication and scope-based permissions.

What does the Stekker API offer?

The Stekker API is a REST API that allows developers and technical integrators to communicate with the Stekker platform. The API provides access to smart charging functionality, battery control (BESS) and market data.

All API communication uses HTTPS and JSON. The API is organization-scoped: each credential grants access to the data of a specific organization.

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer your-api-token

API credentials are created per organization and are tied to specific scopes. A scope determines which parts of the API you can access. The available scopes are:

  • events — receive and send charging events (OCPP/sensor events)
  • bess — management of battery storage systems, grid connections and sensors
  • price_forecast — retrieve day-ahead market prices and price forecasts
  • charge_energy_forecast — retrieve energy consumption forecasts for charging sessions

Stekker provides a separate staging environment to test your integration before going live.

Available endpoints

The API is divided into two main sections:

Smart Charging API

The core API at api.stekker.app/api/v1/ for charging infrastructure integration:

  • Events — receive and process OCPP events and sensor events from charge points. This is the heart of the smart charging integration: meter values, status notifications and session information come in here.
  • Market Price Forecast — retrieve day-ahead energy prices per market region (default NL). Includes current prices, forecasts and the upcoming price minimum. Available at quarter-hourly or hourly intervals.
  • Charge Energy Forecast — request a forecast of the expected energy consumption of a charging session based on historical measurement data.

BESS API

The Battery Energy Storage System API at api.stekker.app/api/bess/v1/ for battery storage integration:

  • Grid Connections — register and manage grid connections with location, fuse limit and market region configuration.
  • Batteries — register batteries with their technical specifications (capacity, charge/discharge power, SoC limits, efficiency). Request optimized charge schedules: cash-optimized (based on market prices) or solar-optimized (based on production and consumption forecasts).
  • Sensors — register sensors on a grid connection and submit measurement data (power, energy import). Retrieve historical measurement data and forecasts per sensor.

The BESS API includes built-in Swagger documentation at /api/bess/v1/swagger_doc.

Documentation

Comprehensive technical documentation, including example messages and protocol descriptions, is available at developer.stekker.com. There you will find:

  • Authentication instructions and example requests
  • Description of the pairing process for charge points
  • OCPP event formats and status notifications
  • Meter values and sensor measurements
  • Charging profiles and smart charging UI integration
  • Day-ahead price data and session pricing

Getting started

Want to start using the Stekker API? Here is how it works:

  1. Contact [email protected] or your account manager and describe your use case.
  2. Our team creates API credentials for your organization, with the appropriate scopes for your integration.
  3. You receive tokens for both the staging and production environments.
  4. Test your integration on the staging environment before going live.

For technical questions during integration, reach out to [email protected].

more posts: