Insight API · Elhub

Insight API

Gjør Elhub-integrasjon for tredjeparter lekende lett.

insight.enersky.no

GET/api/v1/mp/707436200000127151200 OK38 ms

{
  "mpid": "707436200000127151",
  "state": "active",
  "processing": false,
  "expires": "2028-01-21T00:00:00+01:00",
  "meter_metadata": {
    "meter_type_desc": "Consumption",
    "meter_reading_desc": "Automatic",
    "annual_consumption_estimate": 30660
  },
  "customer_metadata": …
}

Fordeler

Noen av fordelene

Med EnerSky Insight får du full tilgang til all tilgjengelig målerdata for tredjeparter, uten å måtte forholde deg til Elhub sitt SOAP meldingsgrensesnitt.

Veldokumentert og versjonert REST API basert på OpenAPI v3.
Grunndata, daglig oppdaterte målerverdier, og historiske verdier opptil 3 år tilbake.
Intuitiv kundeportal med full oversikt over status på porteføljen din.
Bruk EnerSky plattformen direkte, eller bruk eget GLN.
Sluttbrukerhåndtering med automatisert digitalt samtykke.
Målepunktdetaljer med status fra EnerSky og grunndata fra Elhub.

Sluttbrukere og samtykke

Med en tilgangslenke (BRS-NO-624) gir sluttbrukeren selv tilgang til målerdataene sine på Elhub. Du trenger ikke å samle inn målepunkt-IDer på forhånd.

Lag en tilgangslenke i kundeportalen eller gjennom API-et, og send den til sluttbrukeren.
Sluttbrukeren godtar sluttbrukeravtalen digitalt, som privatperson eller for en bedrift.
Deretter logger sluttbrukeren på Elhub Min Side med ID-porten, og velger selv målepunkter og hvor lenge tilgangen skal vare.
Elhub bekrefter tilgangen, og målerverdiene kommer inn i API-et. Du følger hver forespørsel i kundeportalen og i API-ets hendelser.
Lenken kan brukes flere ganger, så sluttbrukeren kan gi tilgang til flere målepunkter senere.
Bruker du eget GLN, hopper sluttbrukeren over avtalen og logger bare på Elhub.

Tilgangsforespørsel

EnerSky ønsker på vegne av Firma AS å be om tilgang til målerdata fra dine strømmålere.

Gjelder

Kari Nordmann

Privatperson

Ikke deg? Lukk denne siden og kontakt Firma AS.

Ber om tilgang

Firma AS

Org.nr. 900123456

Steg

Steg 1, pågår: Godta avtalen og logg på Elhub
Sluttbrukeravtalen er godtatt. Neste: logg på Elhub med ID-porten.
Steg 2, ikke påbegynt: Velg målepunkter
Velg hvilke målepunkter du vil gi tilgang til på Elhub.
Steg 3, ikke påbegynt: Bekreftelse fra Elhub
Vi mottar bekreftelsen fra Elhub, og du er ferdig.

Illustrasjon · eksempelflyt

Kom i gang

Kom i gang med Insight API

Steg 1: Opprett en API-nøkkel
For å ta i bruk Insight API må man først opprette en API-nøkkel i Kundeportalen.
Steg 2: Kall endepunktene
Deretter er det bare å kalle endepunktene!
Steg 3: Tilgangsstyrt per kategori
Endepunktene er kategorisk inndelt, og hvert endepunkt er tilgangsstyrt med lese eller skrivetilgang for den kategorien.

Hvis API-nøkkelen som brukes ikke har de rette tilgangene vil forespørselen bli avvist. For en detaljert oversikt over all funksjonalitet i APIet kan man ta en titt på API-dokumentasjonen.

Be om tilgang til en måler

Forespørselbash

curl -X POST -H 'X-API-Key: my-api-key' \
  -H 'Content-Type: application/json' \
  https://insight.enersky.no/api/v1/mp/subscribe -d '{
    "end_user_identifier": "900900900",
    "mpid": "707057500012345678"
}'

Å be om tilgang til et målepunkt er svært enkelt. Man trenger bare målepunkt-ID og sluttbruker-ID (f.eks organisasjonsnummer).

En tilgangsforespørsel vil ligge klar i sluttbrukerens Elhub Min Side i løpet av et par minutter.

Responsjson

{
  "request_id": "4b362b9b-c06c-4fb8-b330-99a9f227b11b",
  "mpid": "707436200000127151",
  "requested_at": "2025-10-02T13:11:47.012Z"
}

Se status på hele porteføljen

Forespørselbash

curl -H 'X-API-Key: my-api-key' \
  'https://insight.enersky.no/api/v1/mp/inventory'

I porteføljeoversikten får man et raskt innblikk i status på hvert enkelt målepunkt, når siste måleverdier ble mottatt, om det er pågående tilgangsforespørsler, når tilgangen utløper, samt eventuell merknad som beskriver hvorfor tilstanden er slik den er.

Responsjson

{
  "count": 1,
  "inventory": [
    {
      "mpid": "707057500012345678",
      "state": "active",
      "processing": false,
      "updated_at": "2026-10-19T15:21:30.340Z",
      "expires": "2031-10-19T15:21:30.340Z",
      "notice": null
    }
  ]
}

Se målepunktdetaljer

Forespørselbash

curl -H 'X-API-Key: my-api-key' \
  'https://insight.enersky.no/api/v1/mp/707436200000127151'

Målepunktdetaljene inneholder all tilgjengelig metadata på målepunktet, og inkluderer status fra EnerSky, samt grunndata fra Elhub.

Avhengig av hva slags type målepunkt det er, hvor komplett grunndata er i Elhub, samt hvilket tilgangsnivå som er gitt vil enkelte av feltene være null.

Responsjson

{
  "mpid": "707436200000127151",
  "state": "active",
  "requested_at": "2024-09-11T15:27:41.072555+02:00",
  "request_id": "b6b8f780-0039-47b2-8cc0-977a444a4f7f",
  "processing": false,
  "updated_at": "2025-06-19T15:43:41+02:00",
  "expires": "2028-01-21T00:00:00+01:00",
  "notice": null,
  "meter_metadata": {
    "updated_at": "2024-05-01T00:00:00+02:00",
    "address": {
      "street_name": "Minasgate",
      "building_number": "55",
      "city": "SVALBARD",
      "post_code": "0039",
      "country_code": "NO",
      "latitude": "60.97250",
      "longitude": "6.17610"
    },
    "meter_details": {
      "extended_storage": true,
      "meter_number": "70743280",
      "meter_type_code": "E17",
      "meter_type_desc": "Consumption",
      "meter_status_code": "E22",
      "meter_status_desc": "Active",
      "meter_settlement_code": "E02",
      "meter_settlement_desc": "Non-profiled",
      "meter_reading_code": "E13",
      "meter_reading_desc": "Automatic",
      "meter_blocked": null,
      "meter_constant": "1.0",
      "meter_digits": 8,
      "meter_priority": "P",
      "meter_priority_desc": "Priority (Not interruptible)",
      "meter_subtype_consumption_code": "A04",
      "meter_subtype_consumption_desc": "Consumption",
      "meter_subtype_production_code": null,
      "meter_subtype_production_desc": null,
      "annual_consumption_estimate": 30660,
      "annual_production_estimate": null,
      "delivery_obligation": null,
      "load_limit": 985,
      "installed_capacity": null
    },
    "grid_details": {
      "mga_code": "MGA-707430000000",
      "mga_name": null,
      "mga_type": null,
      "country": null,
      "country_code": null,
      "grid_operator_gln": null,
      "grid_operator_desc": null,
      "price_area": null,
      "balance_supplier_gln": "7080005178983",
      "balance_supplier_desc": null
    },
    "description": "Non-profiled cons mp with PT60 and end user 3216",
    "channels": [
      {
        "product": "8716867000030",
        "product_desc": "Energy Active",
        "unit": "kWh",
        "direction": "Out",
        "resolution": "PT60M",
        "exclude_from_settlement": false
      }
    ],
    "taxation_profile": {
      "vat_code": "S",
      "vat_code_desc": "Standard (Normal rate as per Norwegian Tax Authority)",
      "enova_fee_type": "Fixed",
      "enova_fee": "2.5",
      "el_fee": "1.5",
      "el_certificate_share": "1.5",
      "consumption_code": "35",
      "consumption_code_desc": "Households",
      "nace_division_code": "XX"
    }
  },
  "customer_metadata": {
    "updated_at": "2025-09-22T00:00:00+02:00",
    "name": null,
    "given_name": "Daniel",
    "family_name": "Hermansen",
    "addresses": [
      {
        "address_type": "postaladr",
        "street_name": "Fossekallen",
        "country_code": "NO",
        "building_number": "666",
        "post_code": "0120",
        "city": "DRØMMEN",
        "post_office_box": null,
        "care_of": null,
        "attention_of": null,
        "on_behalf_of": null
      }
    ],
    "communication": []
  }
}

Se målerverdier

Forespørselbash

curl -H 'X-API-Key: my-api-key' \
  --url-query 'start=2025-07-01T00:00:00+02:00' \
  'https://insight.enersky.no/api/v1/md/707436200000127151'

Et målepunkt kan ha flere kanaler, med forskjellig retning, oppløsning og produktkode. Alle kanalene er ikke nødvendigvis med i avregningen Elhub gjør. Man kan se hvilke kanaler som er avregnet i målepunktdetaljene.

Når man henter tidsserier med målerverdier vil hvert datapunkt inneholde følgende...

ts: Klokkeslettet verdien gjelder fra, enten en time eller et kvarter.
direction: Enten forbruk eller produksjon.
product: Kanalens produktkode, f.eks 8716867000030 for Aktiv Energi.
resolution: Kanalens tidsoppløsning, f.eks PT60M / PT1H eller PT15M.
value: Verdien som er forbrukt eller produsert, i kWh eller kVArh avhengig av kanaltypen.
method: Hvordan verdien er registrert, f.eks metered, estimated eller temporary.
updated: Klokkeslettet verdien sist ble registrert/oppdatert i kildesystemet (Elhub).
remarks: Merknad, f.eks hvis det er en foreløpig eller endelig estimert verdi.

Responsjson

{
  "mpid": "707436200000127151",
  "values": [
    {
      "ts": "2025-06-30T22:00:00Z",
      "direction": "consumption",
      "product": "8716867000030",
      "resolution": "PT1H",
      "value": "14.241",
      "method": "metered",
      "updated": "2025-07-02T01:15:14.037Z",
      "remarks": null
    },
    ...
  ]
}

Se aggregerte målerverdier

Forespørselbash

curl -H 'X-API-Key: my-api-key' \
  'https://insight.enersky.no/api/v1/md/707436200000127151/summary'

Man kan gjøre aggregerte spørringer med valgfri tidsavgrensning, for eksempel for et år eller måned.

Svaret vil inneholde de aggregerte verdiene for hver enkelt tidsserie (kanal) som er tilgjengelig.

Responsjson

{
  "channels": [
    {
      "direction": "consumption",
      "product": "8716867000030",
      "resolution": "PT1H",
      "min_ts": "2024-04-30T22:00:00Z",
      "max_ts": "2025-08-17T22:00:00Z",
      "min_positive_ts": "2024-04-30T22:00:00Z",
      "max_positive_ts": "2025-08-17T22:00:00Z",
      "min_value": "1.017",
      "max_value": "65.101",
      "total_value": "73723.867"
    }
  ]
}

Kontakt

Kontakt oss

Ønsker du å vite mer om EnerSky Insight? Dykke ned i tekniske detaljer, integrasjonsmuligheter eller bare er nysgjerrig på hva som er mulig å få til?

Ta kontakt, så setter vi opp et uforpliktende møte.

contact@enersky.no
Eirik Larsen, +47 416 70 269
Ekte mennesker svarer, ingen chatroboter.