Alle adressen van een straat opvragen: Address Range API

Wil je alle adressen van een straat opvragen, bijvoorbeeld voor een mailing, bezorgroute of adressenlijst? Tot nu toe kon je met de Nederland Postcode API één adres tegelijk opvragen op basis van postcode en huisnummer. Daar komt nu een nieuw endpoint bij: /address-range. Hiermee vraag je in één verzoek alle adressen binnen een huisnummerreeks van dezelfde straat op, inclusief huisnummertoevoegingen. Het endpoint is vanaf vandaag beschikbaar in beta.

Hoe werkt het?

Je geeft een postcode en een bestaand huisnummer op als referentie, bijvoorbeeld je eigen adres. Daarnaast geef je met een begin- en eindnummer aan welke reeks huisnummers je wilt ophalen. De API geeft vervolgens alle adressen binnen die reeks terug.

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 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=3"
    },
    "meta": {
        "path": "https://api.nederlandpostcode.nl/v1/address-range",
        "from": 1,
        "to": 50,
        "current_page": 1,
        "last_page": 3,
        "per_page": 50,
        "total": 141
    }
}

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.

Wat kost een verzoek?

Een verzoek naar het /address-range endpoint kost 10 credits, in plaats van 1 credit voor een normaal verzoek. Je haalt er dan ook in één keer een complete reeks adressen mee op, waar je anders tientallen losse verzoeken voor nodig zou hebben.

Daarnaast kun je per adres de coördinaten (latitude en longitude) opvragen via de attributes[] query parameter:

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

Alle adressen van een hele straat opvragen

Wil je niet een deel van de straat, maar een complete adressenlijst van de hele straat? Geef dan het laagste en hoogste huisnummer van de straat op als start_number en end_number. Je ontvangt vervolgens alle adressen van de straat die binnen de reeks vallen, inclusief alle huisnummertoevoegingen. Zo hoef je niet elk adres afzonderlijk op te vragen en heb je in één keer een actuele en volledige lijst.

Waarvoor kun je dit gebruiken?

• Bezorg- en installatiediensten - haal in één keer alle adressen op van het deel van de straat waar je actief bent
• Direct mail en buurtacties - stel eenvoudig een adressenlijst samen voor een mailing in een specifiek deel van een straat
• Vastgoed - breng in één keer alle adressen en toevoegingen binnen een pand of bouwblok in kaart, bijvoorbeeld bij taxaties, verkoop of nieuwbouwprojecten
• VvE-beheer - stel eenvoudig een volledig en actueel overzicht samen van alle appartementen en toevoegingen binnen een Vereniging van Eigenaren

Beschikbaar in beta: zo vraag je toegang aan

De Address Range API is uitgebreid getest en werkt vandaag al net zo betrouwbaar als onze andere endpoints. Voorlopig bieden we toegang nog als beta aan, zodat we het endpoint gecontroleerd kunnen uitrollen. Wil je het gebruiken? Dat kan in twee stappen:

1. Start een abonnement bij Nederland Postcode API, als je die nog niet hebt
2. Stuur een e-mail naar [email protected] met het e-mailadres van je account en een korte omschrijving van je use case

We zetten het endpoint dan voor je open.

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 binnen een huisnummerreeks van dezelfde straat opvraagt. Je geeft een postcode, een referentiehuisnummer en een begin- en eindnummer op, en je ontvangt een gepagineerde lijst met alle adressen in die reeks.

Kan ik ook een deel van een straat opvragen?

Ja. Je bepaalt zelf de reeks door het begin- en eindnummer te kiezen, bijvoorbeeld alleen huisnummer 2 tot en met 50. Alleen de adressen binnen die reeks worden teruggegeven.

Worden huisnummertoevoegingen ook teruggegeven?

Ja. Alle adressen binnen de reeks worden teruggegeven, inclusief toevoegingen zoals A, B of 2.

Kan ik ook de coördinaten van elk adres opvragen?

Ja. Via de attributes[] query parameter kun je per adres de coördinaten (latitude en longitude) opvragen door attributes[]=coordinates toe te voegen aan je verzoek.

Hoeveel credits kost een address-range verzoek?

Een verzoek naar het address-range endpoint kost 10 credits, in plaats van 1 credit voor een normaal verzoek. Je haalt er dan ook in één keer een complete reeks adressen mee op.

Is de Address Range API al beschikbaar?

Ja. De Address Range API is uitgebreid getest en werkt, maar wordt voorlopig nog als beta aangeboden. Start een abonnement bij Nederland Postcode API en stuur een e-mail naar [email protected] om toegang aan te vragen.

Meer informatie over de bestaande endpoints vind je in de API documentatie. Vragen over de beta? Neem gerust contact met ons op.