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:

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: