EnerSky Insight API

Gjør Elhub-integrasjon for tredjeparter lekende lett.

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.

Hvordan komme i gang...

For å ta i bruk Insight API må man først opprette en API-nøkkel i Kundeportalen. Deretter er det bare å kalle endepunktene!

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

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.

Respons

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

Se status på hele porteføljen

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.

Respons

{
  "count": 1,
  "inventory": [
    {
      "mpid": "707057500012345678",
      "state": "active",
      "processing": false,
      "updated_at": "2025-12-12T20:15:04.742Z",
      "expires": "2030-12-12T20:15:04.742Z",
      "notice": null
    }
  ]
}

Se målepunktdetaljer

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.

Respons

{
  "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

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.

Respons

{
  "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

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.

Respons

{
  "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"
    }
  ]
}