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.

De Basisregistratie | Toegewijde weergaven BAG en BRK bevat informatie nodig voor implementatie op het Data Verkenner platform.

ID:

dataverkennerBagzoek

Versie:

None

Autorisatie:

Geen; dit is openbare data.

Licentie:

-

Eigenaar:

Gemeente Amsterdam

Uitgever:

Datateam Basis- en Kernregistraties

Productie:

Basisinformatie

Bronhouder:

OIS | gebruik.basisinformatie@amsterdam.nl

Endpoints

REST OpenAPI:

/v1/dataverkenner/bagzoek

WFS kaartlaag:

/v1/wfs/dataverkenner/bagzoek

MVT kaartlaag:

/v1/mvt/dataverkenner/bagzoek

Tabellen

Bagzoek

Autorisatie:

Geen; dit is openbare data.

REST URI:

/v1/dataverkenner/bagzoek/bagzoek

CSV-export:

/v1/dataverkenner/bagzoek/bagzoek?_format=csv

GeoJSON-export:

/v1/dataverkenner/bagzoek/bagzoek?_format=geojson

De volgende velden zijn beschikbaar:

Veldnaam	Type	Identifier	Omschrijving
id	String	☑
identificatie	String	☑	Landelijke identificerende sleutel.
volgnummer	Integer	☑	Volgnummer van de nummeraanduiding in de administratie van de bronhouder.
huisnummer	Integer		Een door het bevoegde gemeentelijke orgaan ten aanzien van een adresseerbaar object toegekende nummering.
huisletter	String		Een door het bevoegde gemeentelijke orgaan ten aanzien van een adresseerbaar object toegekende toevoeging aan een huisnummer in de vorm van een alfanumeriek teken.
huisnummertoevoeging	String		Een door het bevoegde gemeentelijke orgaan ten aanzien van een adresseerbaar object toegekende nadere toevoeging aan een huisnummer of een combinatie van huisnummer en huisletter.
postcode	String		De door PostNL vastgestelde code bestaande uit 4 cijfers en 2 letters (1234AB).
beginGeldigheid	Datetime		De datum waarop de nummeraanduiding geldig is geworden.
eindGeldigheid	Datetime		De datum waarop de nummeraanduiding niet meer geldig is.
typeAdres	String		Hiermee wordt aangegeven of het een relatie betreft vanuit een hoofdadres. Anders is er sprake van een nevenadres (Hoofdadres, Nevenadres).
adresseertVerblijfsobjectIdentificatie	String		Het verblijfsobject (landelijke identificatie) dat door de nummeraanduiding wordt aangeduid.
openbareruimteTypeCode	Integer		De aard van de zodanig benoemde openbare ruimte (01 Weg, 02 Water, 03 Spoorbaan, 04 Terrein, 05 Kunstwerk, 06 Landschappelijk gebied, 07 Administratief gebied) code
openbareruimteIdentificatie	String		Landelijke identificerende sleutel.
openbareruimteNaam	String		Officiële naam openbare ruimte (80 tekens).
woonplaatsIdentificatie	String		Landelijke identificerende code woonplaats Amsterdam 3594 en woonplaats Weesp 3631.
woonplaatsNaam	String		Officiële naam woonplaats.
verblijfsobjectIdentificatie	String		Landelijke identificerende sleutel.
verblijfsobjectVolgnummer	Integer		Uniek volgnummer van de toestand van het object.
verblijfsobjectGeometrie	Geometry		De locatie van het verblijfsobject in het Nationale Rijksdriehoekstelsel.

De volgende query-parameters zijn te gebruiken:

Parameter	Autorisatie	Mogelijke waarden	Werking
adresseertVerblijfsobjectIdentificatie		Tekst	Test op exacte waarde (==)
adresseertVerblijfsobjectIdentificatie[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
adresseertVerblijfsobjectIdentificatie[not]			Test of waarde niet overeenkomt (!=).
adresseertVerblijfsobjectIdentificatie[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
adresseertVerblijfsobjectIdentificatie[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
adresseertVerblijfsobjectIdentificatie[isempty]		true | false	Test of de waarde leeg is (== '' / != '')
beginGeldigheid		yyyy-mm-dd of yyyy-mm-ddThh:mm[:ss[.ms]]	Test op exacte waarde (==)
beginGeldigheid[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
beginGeldigheid[not]			Test of waarde niet overeenkomt (!=).
beginGeldigheid[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
beginGeldigheid[lte]			Test op kleiner dan of gelijk (<=).
beginGeldigheid[lt]			Test op kleiner dan (<).
beginGeldigheid[gt]			Test op groter dan (>).
beginGeldigheid[gte]			Test op groter dan of gelijk (>=).
eindGeldigheid		yyyy-mm-dd of yyyy-mm-ddThh:mm[:ss[.ms]]	Test op exacte waarde (==)
eindGeldigheid[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
eindGeldigheid[not]			Test of waarde niet overeenkomt (!=).
eindGeldigheid[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
eindGeldigheid[lte]			Test op kleiner dan of gelijk (<=).
eindGeldigheid[lt]			Test op kleiner dan (<).
eindGeldigheid[gt]			Test op groter dan (>).
eindGeldigheid[gte]			Test op groter dan of gelijk (>=).
geldigOp		yyyy-mm-dd of yyyy-mm-ddThh:mm[:ss[.ms]]	Test op exacte waarde (==)
huisletter		Tekst	Test op exacte waarde (==)
huisletter[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
huisletter[not]			Test of waarde niet overeenkomt (!=).
huisletter[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
huisletter[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
huisletter[isempty]		true | false	Test of de waarde leeg is (== '' / != '')
huisnummer		Geheel getal	Test op exacte waarde (==)
huisnummer[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
huisnummer[not]			Test of waarde niet overeenkomt (!=).
huisnummer[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
huisnummer[lte]			Test op kleiner dan of gelijk (<=).
huisnummer[lt]			Test op kleiner dan (<).
huisnummer[gt]			Test op groter dan (>).
huisnummer[gte]			Test op groter dan of gelijk (>=).
huisnummertoevoeging		Tekst	Test op exacte waarde (==)
huisnummertoevoeging[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
huisnummertoevoeging[not]			Test of waarde niet overeenkomt (!=).
huisnummertoevoeging[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
huisnummertoevoeging[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
huisnummertoevoeging[isempty]		true | false	Test of de waarde leeg is (== '' / != '')
id		Tekst	Test op exacte waarde (==)
id[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
id[not]			Test of waarde niet overeenkomt (!=).
id[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
id[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
id[isempty]		true | false	Test of de waarde leeg is (== '' / != '')
identificatie		Tekst	Test op exacte waarde (==)
identificatie[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
identificatie[not]			Test of waarde niet overeenkomt (!=).
identificatie[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
identificatie[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
identificatie[isempty]		true | false	Test of de waarde leeg is (== '' / != '')
openbareruimteIdentificatie		Tekst	Test op exacte waarde (==)
openbareruimteIdentificatie[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
openbareruimteIdentificatie[not]			Test of waarde niet overeenkomt (!=).
openbareruimteIdentificatie[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
openbareruimteIdentificatie[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
openbareruimteIdentificatie[isempty]		true | false	Test of de waarde leeg is (== '' / != '')
openbareruimteNaam		Tekst	Test op exacte waarde (==)
openbareruimteNaam[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
openbareruimteNaam[not]			Test of waarde niet overeenkomt (!=).
openbareruimteNaam[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
openbareruimteNaam[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
openbareruimteNaam[isempty]		true | false	Test of de waarde leeg is (== '' / != '')
openbareruimteTypeCode		Geheel getal	Test op exacte waarde (==)
openbareruimteTypeCode[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
openbareruimteTypeCode[not]			Test of waarde niet overeenkomt (!=).
openbareruimteTypeCode[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
openbareruimteTypeCode[lte]			Test op kleiner dan of gelijk (<=).
openbareruimteTypeCode[lt]			Test op kleiner dan (<).
openbareruimteTypeCode[gt]			Test op groter dan (>).
openbareruimteTypeCode[gte]			Test op groter dan of gelijk (>=).
postcode		Tekst	Test op exacte waarde (==)
postcode[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
postcode[not]			Test of waarde niet overeenkomt (!=).
postcode[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
postcode[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
postcode[isempty]		true | false	Test of de waarde leeg is (== '' / != '')
typeAdres		Tekst	Test op exacte waarde (==)
typeAdres[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
typeAdres[not]			Test of waarde niet overeenkomt (!=).
typeAdres[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
typeAdres[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
typeAdres[isempty]		true | false	Test of de waarde leeg is (== '' / != '')
verblijfsobjectGeometrie		GeoJSON of GEOMETRY(x y ...)	Test op exacte waarde (==)
verblijfsobjectGeometrie[intersects]		GeoJSON of POLYGON(x y ...)	Test of er een intersectie is met de waarde.
verblijfsobjectGeometrie[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
verblijfsobjectGeometrie[not]			Test of waarde niet overeenkomt (!=).
verblijfsobjectGeometrie[contains]		Kommagescheiden lijst	Test of er een intersectie is met de waarde.
verblijfsobjectIdentificatie		Tekst	Test op exacte waarde (==)
verblijfsobjectIdentificatie[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
verblijfsobjectIdentificatie[not]			Test of waarde niet overeenkomt (!=).
verblijfsobjectIdentificatie[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
verblijfsobjectIdentificatie[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
verblijfsobjectIdentificatie[isempty]		true | false	Test of de waarde leeg is (== '' / != '')
verblijfsobjectVolgnummer		Geheel getal	Test op exacte waarde (==)
verblijfsobjectVolgnummer[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
verblijfsobjectVolgnummer[not]			Test of waarde niet overeenkomt (!=).
verblijfsobjectVolgnummer[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
verblijfsobjectVolgnummer[lte]			Test op kleiner dan of gelijk (<=).
verblijfsobjectVolgnummer[lt]			Test op kleiner dan (<).
verblijfsobjectVolgnummer[gt]			Test op groter dan (>).
verblijfsobjectVolgnummer[gte]			Test op groter dan of gelijk (>=).
volgnummer		Geheel getal	Test op exacte waarde (==)
volgnummer[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
volgnummer[not]			Test of waarde niet overeenkomt (!=).
volgnummer[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
volgnummer[lte]			Test op kleiner dan of gelijk (<=).
volgnummer[lt]			Test op kleiner dan (<).
volgnummer[gt]			Test op groter dan (>).
volgnummer[gte]			Test op groter dan of gelijk (>=).
woonplaatsIdentificatie		Tekst	Test op exacte waarde (==)
woonplaatsIdentificatie[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
woonplaatsIdentificatie[not]			Test of waarde niet overeenkomt (!=).
woonplaatsIdentificatie[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
woonplaatsIdentificatie[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
woonplaatsIdentificatie[isempty]		true | false	Test of de waarde leeg is (== '' / != '')
woonplaatsNaam		Tekst	Test op exacte waarde (==)
woonplaatsNaam[isnull]		true | false	Test op ontbrekende waarden (IS NULL / IS NOT NULL).
woonplaatsNaam[not]			Test of waarde niet overeenkomt (!=).
woonplaatsNaam[like]		Tekst met jokertekens (* en ?).	Test op gedeelte van tekst.
woonplaatsNaam[in]		Lijst van waarden	Test of de waarde overeenkomst met 1 van de opties (IN).
woonplaatsNaam[isempty]		true | false	Test of de waarde leeg is (== '' / != '')