Skip to main content

API endpoint overview

This page is a hand-written guide to the three core endpoints of the SENS Energy Data API. It is not a full specification — the binding, exhaustive schema (every field, type, and error code) always lives in Swagger UI at api.getsens.energy/api/docs.

Base URL: https://api.getsens.energy. Every request requires the X-API-KEY header — see Authentication.

GET /api/v1/prices​

The main, composite pricing endpoint. Returns electricity prices that combine distribution-side (OSD) and supply-side (sprzedawca) components for a given tariff, optionally computed for a specific annual consumption volume.

Key parameters: osd, sprzedawca, taryfa, market, date, annual_kwh, region, page, size (pagination applies in overview mode, when no specific OSD/retailer pair is given). See also delta queries for the since parameter.

curl -s "https://api.getsens.energy/api/v1/prices?osd=tauron&taryfa=G11" \
  -H "X-API-KEY: $SENS_API_KEY"

GET /api/v1/tariffs​

The catalog of URE-approved tariffs — tariff ID, operator, type (distribution/supply), tariff group, zone count, voltage level, region, and validity period. Supports pagination (page, size, max 1000) and delta filtering via since/If-Modified-Since.

curl -s "https://api.getsens.energy/api/v1/tariffs?size=50" \
  -H "X-API-KEY: $SENS_API_KEY"

GET /api/v1/tariffs/components​

Breaks a single tariff (tariff_id) down into individual price components — name, category, value, unit, currency, zone. Useful when you need the full fee structure instead of the aggregated total from /prices.

curl -s "https://api.getsens.energy/api/v1/tariffs/components?tariff_id=TAURON_G11_2026" \
  -H "X-API-KEY: $SENS_API_KEY"

What's next​