A comprehensive, up-to-date database of Malaysian postcodes, cities, and states. Available in both JSON and CSV formats for easy integration into your applications.

• 2,932 unique postcodes covering all Malaysian states and federal territories
• 443 cities/areas across 16 states and territories
• Multiple formats: JSON and CSV
• State-specific files for optimized loading
• Well-structured and easy to use
• Code examples in Python, JavaScript, and PHP
• Free and open source under CC BY 4.0 license

// Node.js
const postcodes = require('./data/json/postcodes.json');

// Find postcodes for a city
postcodes.states.forEach(state => {
  state.cities.forEach(city => {
    if (city.name === 'Petaling Jaya') {
      console.log(city.postcodes); // ['46000', '46050', ...]
    }
  });
});

# Python
import json

with open('data/json/postcodes.json', 'r') as f:
    data = json.load(f)

# Find postcodes for a city
for state in data['states']:
    for city in state['cities']:
        if city['name'] == 'Shah Alam':
            print(city['postcodes'])  # ['40000', '40100', ...]

import csv

with open('data/csv/postcodes.csv', 'r') as f:
    reader = csv.DictReader(f)
    for row in reader:
        print(f"{row['postcode']} - {row['city']}, {row['state']}")

malaysia-postcodes/
├── data/
│   ├── csv/
│   │   ├── postcodes.csv              # All postcodes in CSV format
│   │   ├── states.csv                 # State code mappings
│   │   └── states/                    # Individual state CSV files
│   │       ├── Johor.csv
│   │       ├── Selangor.csv
│   │       └── ...
│   └── json/
│       ├── postcodes.json             # All postcodes in JSON format
│       └── states/                    # Individual state JSON files
│           ├── johor.json
│           ├── selangor.json
│           └── ...
├── examples/                          # Code examples
│   ├── python_example.py
│   ├── javascript_example.js
│   └── php_example.php
└── process_data.py                    # Data processing script

{
  "metadata": {
    "version": "2025.1",
    "description": "Complete Malaysia postcode database",
    "total_states": 16
  },
  "states": [
    {
      "name": "Selangor",
      "code": "SGR",
      "cities": [
        {
          "name": "Shah Alam",
          "postcodes": ["40000", "40100", "40150", ...]
        }
      ]
    }
  ]
}

postcode,city,state,state_code
40000,Shah Alam,Selangor,SGR
40100,Shah Alam,Selangor,SGR
50000,Kuala Lumpur,Wp Kuala Lumpur,KUL

def validate_postcode(postcode):
    with open('data/csv/postcodes.csv', 'r') as f:
        reader = csv.DictReader(f)
        for row in reader:
            if row['postcode'] == postcode:
                return {
                    'valid': True,
                    'city': row['city'],
                    'state': row['state']
                }
    return {'valid': False}

result = validate_postcode('50000')
# {'valid': True, 'city': 'Kuala Lumpur', 'state': 'Wp Kuala Lumpur'}

const data = require('./data/json/postcodes.json');

function getCitiesByState(stateCode) {
  const state = data.states.find(s => s.code === stateCode);
  return state ? state.cities : [];
}

const selangorCities = getCitiesByState('SGR');
// Returns array of cities in Selangor

import json

with open('data/json/postcodes.json', 'r') as f:
    data = json.load(f)

def get_city_by_postcode(postcode):
    for state in data['states']:
        for city in state['cities']:
            if postcode in city['postcodes']:
                return {
                    'city': city['name'],
                    'state': state['name'],
                    'state_code': state['code']
                }
    return None

info = get_city_by_postcode('40100')
# {'city': 'Shah Alam', 'state': 'Selangor', 'state_code': 'SGR'}

For applications that only need data for specific states, use the individual state files:

// Smaller file size, faster loading
const selangor = require('./data/json/states/selangor.json');

console.log(`${selangor.name} (${selangor.code})`);
console.log(`Cities: ${selangor.cities.length}`);

Check the examples/ directory for complete working examples:

• Python: examples/python_example.py
• JavaScript/Node.js: examples/javascript_example.js
• PHP: examples/php_example.php

Run them to see various usage patterns:

# Python
cd examples && python3 python_example.py

# Node.js
cd examples && node javascript_example.js

# PHP
cd examples && php php_example.php

This database is compiled from community-maintained sources:

• Primary source: AsyrafHussin/malaysia-postcodes
• Last updated: 2025

The data is regularly updated to ensure accuracy. If you find any errors or missing postcodes, please open an issue.

To regenerate all data files from the latest source:

# Download latest data
curl -o /tmp/malaysia-postcodes-new.json \
  https://raw.githubusercontent.com/AsyrafHussin/malaysia-postcodes/main/all.json

# Process and generate files
python3 process_data.py

This will regenerate:

• All CSV files in data/csv/
• All JSON files in data/json/
• State-specific files in both formats

This dataset is perfect for building:

1. Address Validation APIs - Validate Malaysian addresses
2. Postcode Lookup Services - RESTful API for postcode queries
3. E-commerce Platforms - Shipping and delivery zone calculations
4. Form Autocomplete - Dynamic city/state selection based on postcode
5. Logistics Systems - Route planning and zone management
6. Mobile Apps - Offline postcode lookup

// Express.js example
const express = require('express');
const postcodes = require('./data/json/postcodes.json');

const app = express();

app.get('/api/postcode/:code', (req, res) => {
  const code = req.params.code;

  for (const state of postcodes.states) {
    for (const city of state.cities) {
      if (city.postcodes.includes(code)) {
        return res.json({
          postcode: code,
          city: city.name,
          state: state.name,
          state_code: state.code
        });
      }
    }
  }

  res.status(404).json({ error: 'Postcode not found' });
});

app.listen(3000);

Contributions are welcome! If you find any issues or have suggestions:

1. Check existing issues
2. Open a new issue with details
3. Submit a pull request with fixes or improvements

This repository and its data are licensed under CC BY 4.0 DEED.

You are free to:

• Share — copy and redistribute the material
• Adapt — remix, transform, and build upon the material for any purpose

Under the following terms:

• Attribution — You must give appropriate credit and link back to this repository

• Original data compilation: MalaysiaPostcode.com
• Community updates: AsyrafHussin/malaysia-postcodes
• Maintained with contributions from the developer community

Made with ❤️ for Malaysian developers

If this repository helped you, please give it a ⭐️ star!