Alle adressen van een straat opvragen: Address Range API

Wil je alle adressen van een straat opvragen, bijvoorbeeld voor een mailing, bezorgroute, adressenlijst of VvE-beheer? Met de Nederland Postcode API kun je naast afzonderlijke adressen ook in één verzoek alle adressen van een straat of een specifieke huisnummerreeks ophalen via het /address-range endpoint, inclusief huisnummertoevoegingen.

Hoe werkt het?

Je geeft een postcode en een bestaand huisnummer op als referentie. De API gebruikt dit adres om de betreffende straat in de BAG te bepalen. Vervolgens kun je optioneel met een begin- en eindnummer aangeven welke reeks huisnummers je wilt ophalen. Laat beide parameters weg om alle adressen van de betreffende straat op te vragen.

Een straat kan meerdere postcodegebieden bevatten. De adressen in het resultaat kunnen daarom verschillende postcodes hebben.

Voorbeeld API-verzoek

GET https://api.nederlandpostcode.nl/v1/address-range?postcode=1015CN&number=10&start_number=2&end_number=50

Het resultaat is een gepagineerde lijst met alle adressen binnen de opgegeven reeks, inclusief eventuele huisnummertoevoegingen:

{
    "data": [
        {
            "postcode": "1015CN",
            "number": 2,
            "addition": null,
            "street": "Keizersgracht",
            "city": "Amsterdam",
            "municipality": "Amsterdam",
            "province": "Noord-Holland",
            "country": "Nederland"
        },
        {
            "postcode": "1015CN",
            "number": 4,
            "addition": "A",
            "street": "Keizersgracht",
            "city": "Amsterdam",
            "municipality": "Amsterdam",
            "province": "Noord-Holland",
            "country": "Nederland"
        },
        ...
    ],
    "links": {
        "first": "https://api.nederlandpostcode.nl/v1/address-range?postcode=1015CN&number=10&start_number=2&end_number=50&page=1",
        "last": "https://api.nederlandpostcode.nl/v1/address-range?postcode=1015CN&number=10&start_number=2&end_number=50&page=7"
    },
    "meta": {
        "path": "https://api.nederlandpostcode.nl/v1/address-range",
        "from": 1,
        "to": 25,
        "current_page": 1,
        "last_page": 7,
        "per_page": 25,
        "total": 159
    }
}

Met de page parameter blader je eenvoudig door alle pagina's van het resultaat. In meta.total zie je direct het totale aantal adressen binnen de reeks en in meta.last_page het aantal pagina's.

Filteren op huisnummer

Met start_number en end_number kun je het resultaat beperken tot een specifieke huisnummerreeks. Beide parameters moeten samen worden opgegeven. Bijvoorbeeld:

GET https://api.nederlandpostcode.nl/v1/address-range?postcode=1015CN&number=10&start_number=2&end_number=50

Laat start_number en end_number beide weg om alle adressen op de betreffende straat op te vragen.

Alle adressen van een hele straat opvragen

Dit maakt het endpoint ook interessant wanneer je niet vooraf weet welke postcodes bij een straat horen. Je hoeft namelijk niet voor ieder postcodegebied afzonderlijk een aanvraag te doen. De API gebruikt het referentieadres om de straat te bepalen en retourneert vervolgens alle adressen die bij die straat horen.

Stel bijvoorbeeld dat een beheerder van een VvE een adres kent van één van de appartementen. Door dat adres als referentie op te geven, kan de volledige adressenlijst van de betreffende straat worden opgehaald. Wil je alleen de woningen van een bepaald deel van de straat, dan kun je daar met start_number en end_number een huisnummerbereik van maken.

Extra gegevens met attributes[]

Via de attributes[] query parameter kun je per adres ook de coördinaten opvragen.

Wil je bijvoorbeeld de latitude en longitude van ieder adres ontvangen, dan voeg je attributes[]=coordinates toe aan je verzoek:

GET https://api.nederlandpostcode.nl/v1/address-range?postcode=1015CN&number=10&start_number=2&end_number=50&attributes[]=coordinates

Bij /address-range is coordinates het enige ondersteunde attribuut. Wil je andere gegevens, zoals de wijk of buurt, dan vraag je die per adres op via het /address endpoint.

Wat kost een verzoek?

Een verzoek naar het /address-range endpoint kost, net als ieder ander verzoek, 1 credit. Daarmee kun je in één verzoek een volledige huisnummerreeks of alle adressen van een straat ophalen. Voor grotere adreslijsten kan dit aanzienlijk efficiënter zijn dan ieder adres afzonderlijk opvragen.

Waarvoor kun je dit gebruiken?

• VvE-beheer - maak automatisch een overzicht van alle appartementen en toevoegingen binnen een Vereniging van Eigenaren
• Vastgoed - breng in één keer alle adressen en toevoegingen binnen een pand of bouwblok in kaart
• Bezorg- en installatiediensten - haal in één keer alle adressen op van het deel van een straat waar je actief bent
• Direct mail en buurtacties - stel eenvoudig een adressenlijst samen voor een specifiek deel van een straat

Veelgestelde vragen

Wat is de Address Range API?

De Address Range API is een endpoint van de Nederland Postcode API waarmee je in één verzoek alle adressen van een straat of een specifieke huisnummerreeks kunt opvragen. Je geeft een postcode en een bestaand huisnummer op als referentie. De API bepaalt daarmee de betreffende straat in de BAG en retourneert vervolgens de adressen van die straat.

Kan ik ook een deel van een straat opvragen?

Ja. Met start_number en end_number kun je het resultaat beperken tot een specifieke huisnummerreeks, bijvoorbeeld huisnummer 2 tot en met 50. Beide parameters moeten samen worden opgegeven.

Kan ik een hele straat opvragen?

Ja. Laat start_number en end_number weg om alle adressen van de betreffende straat op te vragen.

Kunnen de adressen verschillende postcodes hebben?

Ja. Een straat kan meerdere postcodegebieden bevatten. De API bepaalt eerst de straat op basis van het opgegeven postcode- en huisnummer en retourneert vervolgens de adressen op die straat. Daardoor kunnen de adressen in het resultaat verschillende postcodes hebben.

Worden huisnummertoevoegingen ook teruggegeven?

Ja. Alle adressen worden teruggegeven inclusief eventuele huisnummertoevoegingen, zoals A, B of 2.

Bekijk de volledige API-documentatie voor alle beschikbare parameters en attributen.