MENU navbar-image

Introduction

postco.de is een gratis registratieloze API om Nederlandse Straatnamen, Provincies en Steden op te zoeken. Via een GET of POST Request.

Base URL

https://api.postco.de

Endpoints

GET v1/postcode/{postcode?}/{housenumber?}/{housenumberaddition?}

Example request:
curl --request GET \
    --get "https://api.postco.de/v1/postcode/1011AB/112/A" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://api.postco.de/v1/postcode/1011AB/112/A"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "city": "Amsterdam",
    "housenumber": 112,
    "housenumberaddition": "A",
    "lat": 4.90581405,
    "lng": 52.37776112,
    "municipality": "Amsterdam",
    "pchar": "AB",
    "pnum": 1011,
    "postcode": "1011AB",
    "province": "Noord-Holland",
    "street": "De Ruijterkade"
}
 

Example response (404, No Postcodes Found):


{
    "error": "No Postcodes Found"
}
 

Example response (400, No Postcode Provided):


{
    "error": "Please provide a Postcode"
}
 

Request      

GET v1/postcode/{postcode?}/{housenumber?}/{housenumberaddition?}

URL Parameters

postcode  string  

Een geldige Nederlandse Postcode

housenumber  integer  

Huisnummer

housenumberaddition  string optional  

Huisnummer Toevoeging

POST v1/postcode

Example request:
curl --request POST \
    "https://api.postco.de/v1/postcode" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"postcode\": \"1011AB\",
    \"housenumber\": 112,
    \"housenumberaddition\": \"A\"
}"
const url = new URL(
    "https://api.postco.de/v1/postcode"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "postcode": "1011AB",
    "housenumber": 112,
    "housenumberaddition": "A"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "city": "Amsterdam",
    "housenumber": 112,
    "housenumberaddition": "A",
    "lat": 4.90581405,
    "lng": 52.37776112,
    "municipality": "Amsterdam",
    "pchar": "AB",
    "pnum": 1011,
    "postcode": "1011AB",
    "province": "Noord-Holland",
    "street": "De Ruijterkade"
}
 

Example response (404, No Postcodes Found):


{
    "error": "No Postcodes Found"
}
 

Example response (400, No Postcode Provided):


{
    "error": "Please provide a Postcode"
}
 

Request      

POST v1/postcode

Body Parameters

postcode  string  

Een geldige Nederlandse Postcode

housenumber  integer  

Huisnummer

housenumberaddition  string optional  

Huisnummer Toevoeging