Malaysia Postcodes

A Comprehensive List of Malaysia Postcodes, Complete with City and State Information, available in JSON format.

Overview

This repository provides an extensive collection of Malaysia postcodes, indexed by city and state. It serves as a useful resource for developers, researchers, and anyone interested in postal data for Malaysia.

Data Structure

The data is structured in JSON, and the format is as follows:

{
   "name": "Kelantan",
   "city": [
       {
        "name": "Pasir Mas",
        "postcode": [
            "17000",
            "17007",
            "17009",
            "17010",
            "17020",
            "17030",
            "17040",
            "17050",
            "17060",
            "17070"
        ]
       }
   ]
}

Table of Contents

• All Postcodes
• Johor
• Kedah
• Kelantan
• Kuala Lumpur
• Labuan
• Melaka
• Negeri Sembilan
• Pahang
• Pulau Pinang
• Perak
• Perlis
• Putrajaya
• Sabah
• Sarawak
• Selangor
• Terengganu

What's New

For the latest updates, see the Changelog.

• Postcode data accuracy improvements for Pulau Pinang and Johor (2025-06-27)
  • Added missing postcode 79050 to Iskandar Puteri (Johor)
  • Removed 12 invalid postcodes from Pulau Pinang cities to match official reference
  • Removed incorrect postcode 71590 from Pekan Nenas (Johor)
• Complete coverage review and fixes for multiple states (2025-06-26)
  • Added missing locations: Tenghilan (Sabah), Pusat Mel Miri & Sibu Jaya (Sarawak)
  • Renamed Penang to official name "Pulau Pinang" and updated file name
  • Fixed formatting issues in Negeri Sembilan, Pahang, and Perak
  • Removed invalid postcodes and corrected city names across multiple states
• Added new postcode for TRX (Tun Razak Exchange) in Kuala Lumpur (2025-03-10)
• Removed incorrect-length postcodes from various cities (2023-08-27)

Installation

Install via npm:

npm install malaysia-postcodes

Or via yarn:

yarn add malaysia-postcodes

Usage

Basic Usage

const postcodes = require('malaysia-postcodes');

// Get all postcodes
const all = postcodes.getAll();

// Get postcodes for a specific state
const johor = postcodes.getByState('Johor');
const selangor = postcodes.getByState('Selangor');

// Access individual state data directly
const kedah = postcodes.kedah;
const kelantan = postcodes.kelantan;

Search by Postcode

// Search for a postcode across all states
const results = postcodes.searchByPostcode('50000');
// Returns: [{ state: 'Wp Kuala Lumpur', city: 'Kuala Lumpur', postcode: '50000' }]

Get Cities by State

// Get all cities in a state
const cities = postcodes.getCitiesByState('Johor');
// Returns: ['Ayer Baloi', 'Ayer Hitam', 'Bandar Penawar', ...]

Get Postcodes by City

// Get all postcodes for a specific city
const cityPostcodes = postcodes.getPostcodesByCity('Johor', 'Johor Bahru');
// Returns: ['80000', '80100', '80150', ...]

Available States

• johor - Johor
• kedah - Kedah
• kelantan - Kelantan
• kualaLumpur - Kuala Lumpur
• labuan - Labuan
• melaka - Melaka
• negeriSembilan - Negeri Sembilan
• pahang - Pahang
• perak - Perak
• perlis - Perlis
• pulauPinang - Pulau Pinang
• putrajaya - Putrajaya
• sabah - Sabah
• sarawak - Sarawak
• selangor - Selangor
• terengganu - Terengganu

Contributing

If you find any inaccuracies, typos, or missing data, we welcome contributions! Please feel free to open an issue or submit a pull request.

License

This repository is licensed under the MIT License. See the LICENSE file for more details.