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"
}
Received response:
Request failed with error:
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"
}
Received response:
Request failed with error: