{"id":"stromavtaler","name":"Electricity deals","description":"Electricity deals per local grid with monthly price for a given yearly consumption, from the undocumented endpoint behind Forbrukerr\u00e5det's strompris.no.","documentation":"https://www.strompris.no/","operations":[{"name":"find_local_grid","description":"Find the local grid (nettselskap) and price area for a municipality. Signature: find_local_grid(municipality: string, required; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0).","signature":"find_local_grid(municipality: string, required; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0)","parameters":[{"name":"municipality","type":"string","schema":{"type":"string"},"required":true,"default":null,"description":"Municipality name (case-insensitive; exact match first, then substring, e.g. \"Gloppen\"), a full grid name, or the 4-digit municipality number as a string (e.g. \"4650\"; current numbers and the 2020-2023 ones both work).","unit":null,"display_type":"string"},{"name":"limit","type":"integer","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"display_type":"integer","required":false,"default":25,"description":"Maximum list items returned by the gateway (default 25, maximum 100).","unit":"items"},{"name":"offset","type":"integer","schema":{"type":"integer","minimum":0,"default":0},"display_type":"integer","required":false,"default":0,"description":"Number of list items to skip before returning the page.","unit":"items"}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler/find_local_grid?municipality={municipality}&limit=25&offset=0","output_fields":["grid_id","name","municipality_number","price_area","vat_exempt","el_certificate_exempt"],"output_fields_truncated":false,"canonical_field_aliases":{"name":["name"]},"description_language":"en","documentation":"Find the local grid (nettselskap) and price area for a municipality.\n\nA few municipalities have more than one grid (Drammen has two), so an\nambiguous name or number raises an error listing the candidates; pass\nthe full grid name then (e.g. \"Drammen - \u00d8st (NO1)\").\n\nArgs:\n    municipality: Municipality name (case-insensitive; exact match first,\n        then substring, e.g. \"Gloppen\"), a full grid name, or the 4-digit\n        municipality number as a string (e.g. \"4650\"; current numbers\n        and the 2020-2023 ones both work).\n\nReturns `grid_id`, `name`, `municipality_number` (4-digit string, the\nnumber in use since 2024), `price_area` (NO1 to NO5), `vat_exempt` and\n`el_certificate_exempt`.\n\nData: Forbrukerr\u00e5det (strompris.no). Undocumented API.\n\nSignature: find_local_grid(municipality: string, required; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0).","documentation_language":"en","wiki_get_endpoint":"https://allemannsdata.com/wiki/kilder/stromavtaler/find_local_grid/","wiki_get_url_template":"https://allemannsdata.com/wiki/kilder/stromavtaler/find_local_grid/?municipality={municipality}&limit=25&offset=0","json_endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler/find_local_grid","response_schema":{"type":"object","properties":{"grid_id":{"type":["integer","string","null"]},"name":{"type":["string","null"]},"municipality_number":{"type":["string","null"]},"price_area":{"type":["string","null"]},"vat_exempt":{"type":["boolean","null"]},"el_certificate_exempt":{"type":["boolean","null"]}},"additionalProperties":false,"required":["grid_id","name","municipality_number","price_area"]},"response_schema_status":{"status":"declared","codegen_safe":true,"description":"Maintained response contract."},"entity_projection":{"status":"projected","entity_types":["organization"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"response_schema_url":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler/find_local_grid/schema","endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler/find_local_grid","get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler/find_local_grid?municipality={municipality}&limit=25&offset=0","response_example":{"source":"stromavtaler","operation":"find_local_grid","parameters":{"municipality":"example value"},"data":{"grid_id":1,"name":"Example","municipality_number":"example value","price_area":"example value","vat_exempt":true,"el_certificate_exempt":true},"entities":[],"_meta":{"retrieved_at":"2026-01-15T12:00:00Z","language":"en","content_languages":["en"],"sources":[{"id":"stromavtaler","name":"Electricity deals","description":"Electricity deals per local grid with monthly price for a given yearly consumption, from the undocumented endpoint behind Forbrukerr\u00e5det's strompris.no.","cache_ttl_seconds":3600,"documentation":"https://www.strompris.no/"}]},"_provenance":{"data":{"source":"stromavtaler","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler"},"entities":{"source":"stromavtaler","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler","derived_from":"#/data","description":"Normalized projection of data."}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler/find_local_grid","source":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler","wiki":"https://allemannsdata.com/wiki/kilder/stromavtaler/find_local_grid/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}},{"name":"get_power_deals","description":"Electricity deals in one local grid, cheapest first. Signature: get_power_deals(municipality: string, required; yearly_kwh: integer, kilowatt-hours, optional, default 16000; deal_type: string, optional, default None; limit: integer, items, optional, default 20; offset: integer, items, optional, default 0).","signature":"get_power_deals(municipality: string, required; yearly_kwh: integer, kilowatt-hours, optional, default 16000; deal_type: string, optional, default None; limit: integer, items, optional, default 20; offset: integer, items, optional, default 0)","parameters":[{"name":"municipality","type":"string","schema":{"type":"string"},"required":true,"default":null,"description":"Municipality name or 4-digit number, as in find_local_grid.","unit":null,"display_type":"string"},{"name":"yearly_kwh","type":"integer","schema":{"type":"integer"},"required":false,"default":16000,"description":"Assumed yearly consumption in kWh, 1000-100000 (default 16000). Changes the monthly price of every deal. Unit: kilowatt-hours.","unit":"kilowatt-hours","display_type":"integer"},{"name":"deal_type","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"Restrict to one deal type: hourly_spot, spot, fixed, variable, plus, purchase or other (also accepts spotpris and fastpris). Omit for all types.","unit":null,"display_type":"string"},{"name":"limit","type":"integer","schema":{"type":"integer"},"required":false,"default":20,"description":"Max deals to return, 1-100 (default 20). Unit: items.","unit":"items","display_type":"integer"},{"name":"offset","type":"integer","schema":{"type":"integer"},"required":false,"default":0,"description":"Results to skip before the first one returned (default 0); with limit, pages through every match. Unit: items.","unit":"items","display_type":"integer"}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler/get_power_deals?municipality={municipality}&yearly_kwh=16000&deal_type={deal_type}&limit=20&offset=0","output_fields":["grid","grid.grid_id","grid.name","grid.municipality_number","grid.price_area","grid.vat_exempt","grid.el_certificate_exempt","yearly_kwh","count","returned","deals","deals[].product_id","deals[].name","deals[].type","deals[].supplier","deals[].supplier_org_nr","deals[].monthly_price_nok","deals[].price_ore_per_kwh","deals[].addon_ore_per_kwh","deals[].monthly_fee_nok","deals[].agreement_months","deals[].order_url","deals[].updated"],"output_fields_truncated":false,"canonical_field_aliases":{"name":["grid.name","deals[].name"]},"description_language":"en","documentation":"Electricity deals in one local grid, cheapest first.\n\nPrices are calculated for a yearly consumption, so the same product can\nhave a different monthly price in another grid. Only products currently\noffered to all customers or to new customers are included; expired\nproducts are dropped.\n\nArgs:\n    municipality: Municipality name or 4-digit number, as in\n        find_local_grid.\n    yearly_kwh: Assumed yearly consumption in kWh, 1000-100000 (default\n        16000). Changes the monthly price of every deal.\n    deal_type: Restrict to one deal type: hourly_spot, spot, fixed,\n        variable, plus, purchase or other (also accepts spotpris and\n        fastpris). Omit for all types.\n    limit: Max deals to return, 1-100 (default 20).\n    offset: Results to skip before the first one returned (default 0); with\n        limit, pages through every match.\n\nReturns `grid` (the find_local_grid shape), `yearly_kwh`, `count` (deals\nmatching before the cap), `returned`, and `deals` sorted by monthly price\nascending. Each deal has product_id, name, type, supplier,\nsupplier_org_nr, monthly_price_nok, monthly_kwh, price_ore_per_kwh,\naddon_ore_per_kwh, monthly_fee_nok, agreement_months, order_url and\nupdated.\n\nmonthly_price_nok is upstream's estimate for the current month: the\nenergy price after str\u00f8mst\u00f8tte times monthly_kwh (this month's share of\nyearly_kwh, which follows a seasonal profile), plus fees. Deals whose\nenergy price is not included (management-only products) carry\nenergy_price_included: false and are sorted after all the others.\n\nData: Forbrukerr\u00e5det (strompris.no). Undocumented API.\n\nSignature: get_power_deals(municipality: string, required; yearly_kwh: integer, kilowatt-hours, optional, default 16000; deal_type: string, optional, default None; limit: integer, items, optional, default 20; offset: integer, items, optional, default 0).","documentation_language":"en","wiki_get_endpoint":"https://allemannsdata.com/wiki/kilder/stromavtaler/get_power_deals/","wiki_get_url_template":"https://allemannsdata.com/wiki/kilder/stromavtaler/get_power_deals/?municipality={municipality}&yearly_kwh=16000&deal_type={deal_type}&limit=20&offset=0","json_endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler/get_power_deals","response_schema":{"type":"object","properties":{"grid":{"type":"object","properties":{"grid_id":{"type":["integer","string","null"]},"name":{"type":["string","null"]},"municipality_number":{"type":["string","null"]},"price_area":{"type":["string","null"]},"vat_exempt":{"type":["boolean","null"]},"el_certificate_exempt":{"type":["boolean","null"]}},"additionalProperties":false,"required":["grid_id","name","municipality_number","price_area"]},"yearly_kwh":{"type":"integer"},"count":{"type":"integer"},"returned":{"type":"integer"},"deals":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":["integer","string","null"]},"name":{"type":["string","null"]},"type":{"type":["string","null"]},"supplier":{"type":["string","null"]},"supplier_org_nr":{"type":["string","null"]},"monthly_price_nok":{"type":["number","null"]},"price_ore_per_kwh":{"type":["number","null"]},"addon_ore_per_kwh":{"type":["number","null"]},"monthly_fee_nok":{"type":["number","null"]},"agreement_months":{"type":["integer","null"]},"order_url":{"type":["string","null"],"format":"uri"},"updated":{"type":["string","null"],"format":"date-time"}},"additionalProperties":false,"required":["product_id"]}}},"additionalProperties":false,"required":["grid","yearly_kwh","count","returned","deals"]},"response_schema_status":{"status":"declared","codegen_safe":true,"description":"Maintained response contract."},"entity_projection":{"status":"projected","entity_types":["organization"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"response_schema_url":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler/get_power_deals/schema","endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler/get_power_deals","get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler/get_power_deals?municipality={municipality}&yearly_kwh=16000&deal_type={deal_type}&limit=20&offset=0","response_example":{"source":"stromavtaler","operation":"get_power_deals","parameters":{"municipality":"example value","yearly_kwh":16000,"deal_type":"example value","limit":20,"offset":0},"data":{"grid":{"grid_id":1,"name":"Example","municipality_number":"example value","price_area":"example value","vat_exempt":true,"el_certificate_exempt":true},"yearly_kwh":1,"count":1,"returned":1,"deals":[{"product_id":1,"name":"Example","type":"example value","supplier":"example value","supplier_org_nr":"example value","monthly_price_nok":1.0,"price_ore_per_kwh":1.0,"addon_ore_per_kwh":1.0,"monthly_fee_nok":1.0,"agreement_months":1,"order_url":"https://example.invalid/resource","updated":"2026-01-15T12:00:00Z"}]},"entities":[],"_meta":{"retrieved_at":"2026-01-15T12:00:00Z","language":"en","content_languages":["en"],"sources":[{"id":"stromavtaler","name":"Electricity deals","description":"Electricity deals per local grid with monthly price for a given yearly consumption, from the undocumented endpoint behind Forbrukerr\u00e5det's strompris.no.","cache_ttl_seconds":3600,"documentation":"https://www.strompris.no/"}]},"_provenance":{"data":{"source":"stromavtaler","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler"},"entities":{"source":"stromavtaler","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler","derived_from":"#/data","description":"Normalized projection of data."}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler/get_power_deals","source":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler","wiki":"https://allemannsdata.com/wiki/kilder/stromavtaler/get_power_deals/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}}],"operation_schema_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler/{operation}/schema","related_sources":[{"id":"strompris","name":"Norwegian electricity spot prices","reason":"Hourly spot prices behind the variable and spot-price deals.","api":"https://allemannsdata.com/wiki/api/v1/kilder/strompris","wiki":"https://allemannsdata.com/wiki/kilder/strompris/"},{"id":"entsoe","name":"ENTSO-E Transparency Platform","reason":"Day-ahead market prices for the same price areas.","api":"https://allemannsdata.com/wiki/api/v1/kilder/entsoe","wiki":"https://allemannsdata.com/wiki/kilder/entsoe/"}],"_meta":{"retrieved_at":"2026-10-12T00:41:47Z","language":"en","content_languages":["en"],"sources":[{"id":"stromavtaler","name":"Electricity deals","description":"Electricity deals per local grid with monthly price for a given yearly consumption, from the undocumented endpoint behind Forbrukerr\u00e5det's strompris.no.","documentation":"https://www.strompris.no/","cache_ttl_seconds":3600}]},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler","names":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler?view=names","compact":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler?view=compact","full":"https://allemannsdata.com/wiki/api/v1/kilder/stromavtaler","wiki":"https://allemannsdata.com/wiki/kilder/stromavtaler/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}