Free plan

Postal Codes API

South African postal codes for every suburb

Look up street and box postal codes by suburb name or numeric code. Supports fuzzy search, area filtering, and exact code lookup. Included in the free plan.

Get API Key Free View Docs

What is included

Suburb Search

Fuzzy trigram search on suburb name for 3 or more characters, ILIKE for shorter queries.

Street and Box Codes

Both street delivery codes and PO box codes returned for every suburb.

Exact Code Lookup

Look up a suburb by its numeric postal code directly.

Area Filtering

Filter results by city or area name, case-insensitive.

Paginated Results

Up to 100 results per page with total count in meta.

Free Plan

No paid plan required. Available on all tiers including the free plan.

Available endpoints

GET/v1/postal-codesList and search postal codes

GET/v1/postal-codes/{suburbOrCode}Look up by suburb or code

Example

Request

curl "https://api.apply.org.za/v1/postal-codes?search=sandton" \
  -H "X-API-Key: uafm_live_your_token"

Response

{
  "data": [
    {
      "id": 4821,
      "suburb": "Sandton",
      "street_code": "2196",
      "box_code": "2146",
      "area": "Johannesburg"
    },
    {
      "id": 4822,
      "suburb": "Sandton CBD",
      "street_code": "2196",
      "box_code": "2196",
      "area": "Johannesburg"
    }
  ],
  "meta": { "total": 2, "page": 1, "per_page": 20 }
}

Ready to start building?

Free plan includes access to this endpoint. No credit card required.

Get started free