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:

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.
standaardjaarverbruikLevering	Integer		Schatting op basis van historische gegevens van het jaarverbruik in kWh (elektriciteit) of nm3 (gas).
standaardjaarverbruikTeruglevering	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[lt]			Test op kleiner dan (<).
aantalAansluitingen[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
aantalAansluitingen[lte]			Test op kleiner dan of gelijk (<=).
aantalAansluitingen[not]			Test of waarde niet overeenkomt (!=).
aantalAansluitingen[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
aantalAansluitingen[gte]			Test op groter dan of gelijk (>=).
aantalAansluitingen[gt]			Test op groter dan (>).
buurtCode		Tekst	Test op exacte waarde (==)
buurtCode[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
buurtCode[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
buurtNaam		Tekst	Test op exacte waarde (==)
buurtNaam[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
buurtNaam[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
gemeente		Tekst	Test op exacte waarde (==)
gemeente[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
gemeente[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
id		Geheel getal	Test op exacte waarde (==)
id[lt]			Test op kleiner dan (<).
id[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
id[lte]			Test op kleiner dan of gelijk (<=).
id[not]			Test of waarde niet overeenkomt (!=).
id[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
id[gte]			Test op groter dan of gelijk (>=).
id[gt]			Test op groter dan (>).
jaar		Geheel getal	Test op exacte waarde (==)
jaar[lt]			Test op kleiner dan (<).
jaar[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
jaar[lte]			Test op kleiner dan of gelijk (<=).
jaar[not]			Test of waarde niet overeenkomt (!=).
jaar[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
jaar[gte]			Test op groter dan of gelijk (>=).
jaar[gt]			Test op groter dan (>).
jaarKwartaal		Tekst	Test op exacte waarde (==)
jaarKwartaal[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
jaarKwartaal[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
jaarMaand		Tekst	Test op exacte waarde (==)
jaarMaand[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
jaarMaand[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
klantsegment		Tekst	Test op exacte waarde (==)
klantsegment[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
klantsegment[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
plaats		Tekst	Test op exacte waarde (==)
plaats[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
plaats[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
product		Tekst	Test op exacte waarde (==)
product[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
product[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
provincie		Tekst	Test op exacte waarde (==)
provincie[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
provincie[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
standaardjaarverbruikLevering		Geheel getal	Test op exacte waarde (==)
standaardjaarverbruikLevering[lt]			Test op kleiner dan (<).
standaardjaarverbruikLevering[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
standaardjaarverbruikLevering[lte]			Test op kleiner dan of gelijk (<=).
standaardjaarverbruikLevering[not]			Test of waarde niet overeenkomt (!=).
standaardjaarverbruikLevering[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
standaardjaarverbruikLevering[gte]			Test op groter dan of gelijk (>=).
standaardjaarverbruikLevering[gt]			Test op groter dan (>).
standaardjaarverbruikTeruglevering		Geheel getal	Test op exacte waarde (==)
standaardjaarverbruikTeruglevering[lt]			Test op kleiner dan (<).
standaardjaarverbruikTeruglevering[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
standaardjaarverbruikTeruglevering[lte]			Test op kleiner dan of gelijk (<=).
standaardjaarverbruikTeruglevering[not]			Test of waarde niet overeenkomt (!=).
standaardjaarverbruikTeruglevering[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
standaardjaarverbruikTeruglevering[gte]			Test op groter dan of gelijk (>=).
standaardjaarverbruikTeruglevering[gt]			Test op groter dan (>).
wijkCode		Tekst	Test op exacte waarde (==)
wijkCode[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
wijkCode[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
wijkNaam		Tekst	Test op exacte waarde (==)
wijkNaam[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
wijkNaam[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).

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:

Veldnaam	Type	Identifier	Omschrijving
id	Integer	☑	Unieke aanduiding record.
peildatum	Integer		Peildatum waarop het verbruik betrekking heeft.
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.
maand	String		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.
gemeente	String		De gemeente 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.
standaardjaarverbruikLevering	Integer		Schatting op basis van historische gegevens van het jaarverbruik in kWh (elektriciteit) of nm3 (gas).
standaardjaarverbruikTeruglevering	Integer		Schatting op basis van historische gegevens van de jaarlijkse teruglevering in kWh (elektriciteit) of nm3 (gas).
aantalAansluitingen	Integer		Het aantal afleverpunten.
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[lt]			Test op kleiner dan (<).
aantalAansluitingen[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
aantalAansluitingen[lte]			Test op kleiner dan of gelijk (<=).
aantalAansluitingen[not]			Test of waarde niet overeenkomt (!=).
aantalAansluitingen[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
aantalAansluitingen[gte]			Test op groter dan of gelijk (>=).
aantalAansluitingen[gt]			Test op groter dan (>).
buurtCode		Tekst	Test op exacte waarde (==)
buurtCode[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
buurtCode[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
buurtNaam		Tekst	Test op exacte waarde (==)
buurtNaam[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
buurtNaam[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
gemeente		Tekst	Test op exacte waarde (==)
gemeente[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
gemeente[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
id		Geheel getal	Test op exacte waarde (==)
id[lt]			Test op kleiner dan (<).
id[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
id[lte]			Test op kleiner dan of gelijk (<=).
id[not]			Test of waarde niet overeenkomt (!=).
id[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
id[gte]			Test op groter dan of gelijk (>=).
id[gt]			Test op groter dan (>).
jaar		Geheel getal	Test op exacte waarde (==)
jaar[lt]			Test op kleiner dan (<).
jaar[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
jaar[lte]			Test op kleiner dan of gelijk (<=).
jaar[not]			Test of waarde niet overeenkomt (!=).
jaar[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
jaar[gte]			Test op groter dan of gelijk (>=).
jaar[gt]			Test op groter dan (>).
jaarKwartaal		Tekst	Test op exacte waarde (==)
jaarKwartaal[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
jaarKwartaal[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
jaarMaand		Tekst	Test op exacte waarde (==)
jaarMaand[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
jaarMaand[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
klantsegment		Tekst	Test op exacte waarde (==)
klantsegment[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
klantsegment[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
maand		Tekst	Test op exacte waarde (==)
maand[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
maand[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
maand[not]			Test of waarde niet overeenkomt (!=).
maand[isempty]		true | false	Test of de waarde leeg is (== '' / != '')
maand[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
netbeheerder		Tekst	Test op exacte waarde (==)
netbeheerder[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
netbeheerder[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
peildatum		Geheel getal	Test op exacte waarde (==)
peildatum[lt]			Test op kleiner dan (<).
peildatum[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
peildatum[lte]			Test op kleiner dan of gelijk (<=).
peildatum[not]			Test of waarde niet overeenkomt (!=).
peildatum[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
peildatum[gte]			Test op groter dan of gelijk (>=).
peildatum[gt]			Test op groter dan (>).
product		Tekst	Test op exacte waarde (==)
product[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
product[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
standaardjaarverbruikLevering		Geheel getal	Test op exacte waarde (==)
standaardjaarverbruikLevering[lt]			Test op kleiner dan (<).
standaardjaarverbruikLevering[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
standaardjaarverbruikLevering[lte]			Test op kleiner dan of gelijk (<=).
standaardjaarverbruikLevering[not]			Test of waarde niet overeenkomt (!=).
standaardjaarverbruikLevering[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
standaardjaarverbruikLevering[gte]			Test op groter dan of gelijk (>=).
standaardjaarverbruikLevering[gt]			Test op groter dan (>).
standaardjaarverbruikTeruglevering		Geheel getal	Test op exacte waarde (==)
standaardjaarverbruikTeruglevering[lt]			Test op kleiner dan (<).
standaardjaarverbruikTeruglevering[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
standaardjaarverbruikTeruglevering[lte]			Test op kleiner dan of gelijk (<=).
standaardjaarverbruikTeruglevering[not]			Test of waarde niet overeenkomt (!=).
standaardjaarverbruikTeruglevering[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
standaardjaarverbruikTeruglevering[gte]			Test op groter dan of gelijk (>=).
standaardjaarverbruikTeruglevering[gt]			Test op groter dan (>).
wijkCode		Tekst	Test op exacte waarde (==)
wijkCode[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
wijkCode[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).
wijkNaam		Tekst	Test op exacte waarde (==)
wijkNaam[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
wijkNaam[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
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).