Skip to main content

Quickstart

1. Sign up​

Create an account at getsens.energy — the Early Access form lets you start a free trial. After signing up you get access to the customer portal (portal.getsens.energy), where you'll generate an API key.

2. Generate an API key​

In the customer portal: Integrations → API Keys → Generate Key. Keys look like sens_live_... — treat it like a password, never commit it to a repo. More on key scoping and tiers: Authentication.

3. Make your first request​

The /api/v1/prices endpoint returns composite electricity prices for a given DSO (OSD), retailer, and tariff:

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

Example response​

A real response to the request above (not illustrative data — this is actually what it looks like), trimmed to the fields that matter most:

{
  "meta": {
    "mode": "party_sheet",
    "resolved": { "osd": "TAURON Dystrybucja S.A.", "taryfa": "G11" },
    "last_updated_at": "2026-08-21T14:28:02.105112730Z"
  },
  "offers": [
    {
      "tariff_code": "G11",
      "zones": ["Calodobowy"],
      "summary": {
        "variable_total_pln_per_kwh": { "Calodobowy": 0.2795 },
        "fixed_total_pln_per_month": 22.8
      }
    }
  ],
  "warnings": []
}

The offers[].supply/distribution/global fields trimmed here carry the full, auditable breakdown down to each individual component (name, value, unit, the source tariff's effective period) — not just a summed rate. The full, binding schema, including fields that depend on the query mode (overview, pair, party_sheet, market_pair, market_only), always lives in Swagger UI.

4. What's next​