free · no auth · hosted in south africa

south african postal code & suburb search api

search over 4,000 south african suburbs and postal codes. find a code by typing a suburb name, or find which suburbs use a specific code. returns results with province information.

try it

suburb name or postal code

// response will appear here

endpoint

GET https://api.zanode.co.za/api/postal/search

parameter	type	description
q	string	suburb name (partial or full) or postal code number. minimum 2 characters.

response

{
  "status": "success",
  "data": {
    "count": 1,
    "results": [
      {
        "postalCode": "7700",           // SA postal code
        "placeName": "Rondebosch",       // suburb/town name
        "province": "Western Cape"       // SA province
      }
    ]
  }
}

code examples

curl

curl "https://api.zanode.co.za/api/postal/search?q=rondebosch"

javascript

const res = await fetch(
  "https://api.zanode.co.za/api/postal/search?q=rondebosch"
);
const { data } = await res.json();
console.log(data.results[0].postalCode); // "7700"

want the full zanode platform?

git-push deploys, managed postgres, and predictable pricing on south african servers.

join the waitlist for a 3-month trial when we launch. no credit card required.