Kom igång

Göteborg Energis utvecklarportal samlar de API:er som Göteborg Energi erbjuder utvecklare, tillsammans med guider för hur du använder dem.

Vem är portalen till för?

• Smarta hem-användare som programmerar sin egen hemautomation, till exempel för att ladda elbilen eller köra värmepumpen när elnätsavgiften är låg.
• Företag inom energioptimering som erbjuder smart styrning till konsumenter och företag.
• Organisationer som optimerar sin egen elanvändning, som transportföretag med elbussflottor.

Tillgängliga API:er

API	Vad du får
Grid Tariff API	Alla elnätstariffer från Göteborg Energi Nät AB, inklusive timpriser för tariffer med dynamisk effektavgift.

Miljöer

Alla API:er finns i två miljöer:

Miljö	Bas-URL	Används till
UAT	https://api.uat.goteborgenergi.cloud	Utveckling och test av din integration.
Produktion	https://api.goteborgenergi.cloud	Din applikation i drift.

Båda miljöerna har samma endpoints och svarsformat, så för att gå från UAT till produktion behöver du bara byta bas-URL. ID:n (till exempel tariff-ID:n) är desamma i båda miljöerna.

anteckning

Timpriser (/prices) finns ännu inte i produktion. Använd UAT tills vidare.

Autentisering

Behövs inte. API:erna är öppna: du behöver inget konto, ingen API-nyckel och ingen token.

Gör ditt första anrop

Hämta alla elnätstariffer från UAT:

curl https://api.uat.goteborgenergi.cloud/gridtariff/v0/tariffs/

Svaret är JSON:

{
  "tariffs": [
    {
      "id": "2d3d3e89-9fb0-4db4-be93-806a0e891fe8",
      "name": "Småhus och företag, Max 63A",
      "product": "GNM63",
      "validPeriod": {
        "fromIncluding": "2026-01-01",
        "toExcluding": "2027-01-01"
      },
      ...
    }
  ],
  "calendarPatterns": [ ... ]
}

Fortsätt med översikten över Grid Tariff API för att lära dig vad datan betyder.

Bra att veta

• Format: Svaren är JSON (UTF-8). Textfält i datan, som tariffnamn och beskrivningar, är på svenska.

• Datum och tider följer ISO 8601. Tidpunkter anges med UTC-förskjutning, till exempel 2026-10-14T08:00:00+02:00. Tidslängder anges med ISO 8601-notation: P1M är en månad, P1D ett dygn och PT1H en timme.

• Fel returneras som Problem Details (RFC 9457) med innehållstypen application/problem+json:

  {
    "title": "Invalid Date format.",
    "status": 400,
    "detail": "Invalid Date format 'banana' in parameter 'date'."
  }

• Anropa API:et från din server eller app, inte från en webbsida. Anrop som skickas från JavaScript i en webbläsare stöds inte för närvarande.

• Ange namnet på din applikation i headern User-Agent, till exempel my-charging-app/1.2. Det hjälper oss att se hur API:t används. Vissa generiska klientnamn, som Pythons standardvärde Python-urllib, blockeras för närvarande.

• Versionshantering: API-versionen ingår i sökvägen (/v0).

Få hjälp

Mejla frågor om API:t till timpris_elnat@goteborgenergi.se. Rapportera säkerhetsbrister privat till security@goteborgenergi.se.