Het Dataplatform van gemeente Amsterdam gaat het gebruik van een API key bij het gebruik van API's verplicht stellen. Hiermee wil het Dataplatform inzicht krijgen wie gebruik maakt van haar APIs, zodat het Dataplatform kan communiceren over updates en wijzigingen in de API's. Eventuele wijzigingen in de API's kunnen dan tijdig geïmplementeerd worden in uw systemen. Dit gaat gelden voor alle zogenaamde 'DSO API's' van het Dataplatform van gemeente Amsterdam.

Het gebruik van een API key bij de aanroep van een API van het Dataplatform van gemeente Amsterdam is vanaf half september optioneel. In overleg met de dataorganisatie wordt een deadline vastgesteld voor het moment vanaf wanneer de API keys verplicht worden. U kunt de API's van het Dataplatform dan niet meer gebruiken zonder een API key mee te geven.

Dit heeft gevolgen voor uw systemen!

Vraag tijdig een API key aan om uw systemen hierop aan te passen. U kunt met dit formulier een API key aanvragen.

Energieverbruik MRA

Verbruiksdata gas en elektricteit van de metropoolregio Amsterdam.

ID:
energieverbruikMra
Versie:
None
Autorisatie:
Geen; dit is openbare data.
Licentie:
public
Eigenaar:
Gemeente Amsterdam
Uitgever:
Datateam Stedelijke Ontwikkeling en Beheer
Productie:
Datateam Stedelijke Ontwikkeling en Beheer
Bronhouder:
datateamsob@amsterdam.nl

Endpoints

REST OpenAPI:
/v1/energieverbruik_mra

Tabellen

Elektriciteit en gasverbruik liander

Verbruiksdata gas en elektricteit van de metropoolregio Amsterdam geleverd door Liander.

Autorisatie:
Geen; dit is openbare data.
REST URI:
/v1/energieverbruik_mra/elektriciteit_en_gasverbruik_liander
CSV-export:
/v1/energieverbruik_mra/elektriciteit_en_gasverbruik_liander?_format=csv
GeoJSON-export:
/v1/energieverbruik_mra/elektriciteit_en_gasverbruik_liander?_format=geojson

De volgende velden zijn beschikbaar:

Veldnaam Type Identifier Omschrijving
id Integer ☑ Unieke aanduiding record.
jaar Integer Het jaar waarop het verbruik betrekking heeft.
jaarKwartaal String Het jaar en kwartaal waarop het verbruik betrekking heeft.
jaarMaand String Het jaar en de maand waarop het verbruik betrekking heeft.
product String Het producttype: ELK = elektriciteit, GAS = gas.
klantsegment String Typering van de grootte van de aansluiting: KVB = kleinverbruik, GVB = grootverbruik.
provincie String De provincie waar binnen de aansluitingen zich bevinden.
gemeente String De gemeente waar binnen de aansluitingen zich bevinden.
plaats String De plaats waar binnen de aansluitingen zich bevinden.
wijkCode String Code van de wijk waar binnen de aansluitingen zich bevinden.
wijkNaam String Naam van de wijk waar binnen de aansluitingen zich bevinden.
buurtCode String Code van de buurt waar binnen de aansluitingen zich bevinden..
buurtNaam String Naam van de buurt waar binnen de aansluitingen zich bevinden.
levering Integer Schatting op basis van historische gegevens van het jaarverbruik in kWh (elektriciteit) of nm3 (gas).
teruglevering Integer Schatting op basis van historische gegevens van de jaarlijkse teruglevering in kWh (elektriciteit) of nm3 (gas).
aantalAansluitingen Integer Het aantal afleverpunten.

De volgende query-parameters zijn te gebruiken:

Parameter Autorisatie Mogelijke waarden Werking
aantalAansluitingen Geheel getal Test op exacte waarde (==)
aantalAansluitingen[gt] Test op groter dan (>).
aantalAansluitingen[lt] Test op kleiner dan (<).
aantalAansluitingen[lte] Test op kleiner dan of gelijk (<=).
aantalAansluitingen[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
aantalAansluitingen[gte] Test op groter dan of gelijk (>=).
aantalAansluitingen[not] Test of waarde niet overeenkomt (!=).
aantalAansluitingen[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
buurtCode Tekst Test op exacte waarde (==)
buurtCode[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
buurtCode[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
buurtCode[not] Test of waarde niet overeenkomt (!=).
buurtCode[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
buurtCode[isempty] true | false Test of de waarde leeg is (== '' / != '')
buurtNaam Tekst Test op exacte waarde (==)
buurtNaam[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
buurtNaam[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
buurtNaam[not] Test of waarde niet overeenkomt (!=).
buurtNaam[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
buurtNaam[isempty] true | false Test of de waarde leeg is (== '' / != '')
gemeente Tekst Test op exacte waarde (==)
gemeente[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
gemeente[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
gemeente[not] Test of waarde niet overeenkomt (!=).
gemeente[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
gemeente[isempty] true | false Test of de waarde leeg is (== '' / != '')
id Geheel getal Test op exacte waarde (==)
id[gt] Test op groter dan (>).
id[lt] Test op kleiner dan (<).
id[lte] Test op kleiner dan of gelijk (<=).
id[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
id[not] Test of waarde niet overeenkomt (!=).
id[gte] Test op groter dan of gelijk (>=).
id[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
jaar Geheel getal Test op exacte waarde (==)
jaar[gt] Test op groter dan (>).
jaar[lt] Test op kleiner dan (<).
jaar[lte] Test op kleiner dan of gelijk (<=).
jaar[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
jaar[gte] Test op groter dan of gelijk (>=).
jaar[not] Test of waarde niet overeenkomt (!=).
jaar[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
jaarKwartaal Tekst Test op exacte waarde (==)
jaarKwartaal[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
jaarKwartaal[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
jaarKwartaal[not] Test of waarde niet overeenkomt (!=).
jaarKwartaal[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
jaarKwartaal[isempty] true | false Test of de waarde leeg is (== '' / != '')
jaarMaand Tekst Test op exacte waarde (==)
jaarMaand[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
jaarMaand[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
jaarMaand[not] Test of waarde niet overeenkomt (!=).
jaarMaand[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
jaarMaand[isempty] true | false Test of de waarde leeg is (== '' / != '')
klantsegment Tekst Test op exacte waarde (==)
klantsegment[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
klantsegment[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
klantsegment[not] Test of waarde niet overeenkomt (!=).
klantsegment[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
klantsegment[isempty] true | false Test of de waarde leeg is (== '' / != '')
levering Geheel getal Test op exacte waarde (==)
levering[gt] Test op groter dan (>).
levering[lt] Test op kleiner dan (<).
levering[lte] Test op kleiner dan of gelijk (<=).
levering[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
levering[gte] Test op groter dan of gelijk (>=).
levering[not] Test of waarde niet overeenkomt (!=).
levering[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
plaats Tekst Test op exacte waarde (==)
plaats[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
plaats[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
plaats[not] Test of waarde niet overeenkomt (!=).
plaats[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
plaats[isempty] true | false Test of de waarde leeg is (== '' / != '')
product Tekst Test op exacte waarde (==)
product[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
product[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
product[not] Test of waarde niet overeenkomt (!=).
product[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
product[isempty] true | false Test of de waarde leeg is (== '' / != '')
provincie Tekst Test op exacte waarde (==)
provincie[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
provincie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
provincie[not] Test of waarde niet overeenkomt (!=).
provincie[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
provincie[isempty] true | false Test of de waarde leeg is (== '' / != '')
teruglevering Geheel getal Test op exacte waarde (==)
teruglevering[gt] Test op groter dan (>).
teruglevering[lt] Test op kleiner dan (<).
teruglevering[lte] Test op kleiner dan of gelijk (<=).
teruglevering[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
teruglevering[gte] Test op groter dan of gelijk (>=).
teruglevering[not] Test of waarde niet overeenkomt (!=).
teruglevering[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
wijkCode Tekst Test op exacte waarde (==)
wijkCode[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
wijkCode[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
wijkCode[not] Test of waarde niet overeenkomt (!=).
wijkCode[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
wijkCode[isempty] true | false Test of de waarde leeg is (== '' / != '')
wijkNaam Tekst Test op exacte waarde (==)
wijkNaam[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
wijkNaam[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
wijkNaam[not] Test of waarde niet overeenkomt (!=).
wijkNaam[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
wijkNaam[isempty] true | false Test of de waarde leeg is (== '' / != '')