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:

default

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

Gas en elektriciteit maand liander

Verbruiksdata gas en elektriciteit per maand van de Metropoolregio Amsterdam geleverd door Liander.

Autorisatie:

Geen; dit is openbare data.

REST URI:

/v1/energieverbruik_mra/gas_en_elektriciteit_maand_liander

CSV-export:

/v1/energieverbruik_mra/gas_en_elektriciteit_maand_liander?_format=csv

GeoJSON-export:

/v1/energieverbruik_mra/gas_en_elektriciteit_maand_liander?_format=geojson

De volgende velden zijn beschikbaar:

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

De volgende query-parameters zijn te gebruiken:

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

Gas en elektriciteit kwartaal

Verbruiksdata gas en elektriciteit per kwartaal van de Metropoolregio Amsterdam. Samengevoegde tabel met verbruiksdata van Liander en Stedin.

Autorisatie:

Geen; dit is openbare data.

REST URI:

/v1/energieverbruik_mra/gas_en_elektriciteit_kwartaal

CSV-export:

/v1/energieverbruik_mra/gas_en_elektriciteit_kwartaal?_format=csv

GeoJSON-export:

/v1/energieverbruik_mra/gas_en_elektriciteit_kwartaal?_format=geojson

De volgende velden zijn beschikbaar:

Veld ID	Veldnaam	Type	Identifier	Omschrijving
id	Energieverbruik ID	Integer	☑	Unieke aanduiding record.
peildatum	Energieverbruik peildatum	Integer		Peildatum waarop het verbruik betrekking heeft.
jaar	Energieverbruik jaar	Integer		Het jaar waarop het verbruik betrekking heeft.
jaarKwartaal	Energieverbruik kwartaal van jaar	String		Het jaar en kwartaal waarop het verbruik betrekking heeft.
product	Energieverbruik producttype	String		Het producttype: ELK = elektriciteit, GAS = gas.
klantsegment	Klanttypering	String		Typering van de grootte van de aansluiting: KVB = kleinverbruik, GVB = grootverbruik.
gemeente	Aansluiting gemeente	String		De gemeente waar binnen de aansluitingen zich bevinden.
wijkCode	Aansluiting wijkcode	String		Code van de wijk waar binnen de aansluitingen zich bevinden.
wijkNaam	Aansluiting wijknaam	String		Naam van de wijk waar binnen de aansluitingen zich bevinden.
buurtCode	Aansluiting buurtcode	String		Code van de buurt waar binnen de aansluitingen zich bevinden..
buurtNaam	Aansluiting buurtnaam	String		Naam van de buurt waar binnen de aansluitingen zich bevinden.
standaardjaarLevering	Schatting levering per jaar	Integer		Schatting op basis van historische gegevens van het jaarverbruik in kWh (elektriciteit) of nm3 (gas).
standaardjaarTeruglevering	Schatting teruglevering per jaar	Integer		Schatting op basis van historische gegevens van de jaarlijkse teruglevering in kWh (elektriciteit) of nm3 (gas).
aantalAansluitingen	Energieverbruik Aantal aansluitingen	Integer		Het aantal afleverpunten.
netbeheerder	Energieverbruik netbeheerder	String		Netbeheerder van de verbruiksdata.

De volgende query-parameters zijn te gebruiken:

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