Skip to content
API v1 now available

Malaysian Postcodes, instantly

A clean, developer-friendly REST API for postcode lookup across Malaysia. Access 2,932 postcodes across 443 cities in all 16 states and federal territories.

Postcodes
2,932

complete and verified

Cities
443

across the country

States
16

states & territories

Built for developers

Clean endpoints, predictable responses, token-based auth. Everything you need to integrate Malaysian postcode data into your application.

RESTful Endpoints

Look up postcodes by number, search cities and states, or browse all records. Clean, predictable JSON responses with consistent error handling.

  • GET /api/postcode/{postcode}
  • GET /api/search?q={query}
  • GET /api/states

Token Authentication

Secure your integration with Laravel Sanctum API tokens. Register once, generate a Bearer token, and manage multiple tokens from your dashboard.

  • Bearer token auth
  • Multiple token support
  • Revoke anytime

Comprehensive Coverage

Complete Malaysian postcode database covering all 16 states and federal territories. Every postcode includes city, state name, and state code for easy filtering.

Johor Selangor Penang Sabah Sarawak +11 more

Ready in under a minute

Register, grab your API token, and start making requests. Clean JSON responses with consistent formatting.

Terminal
$ curl -H "Authorization: Bearer YOUR_TOKEN" \
http://localhost/api/postcode/50000
Response
{
  "success": true,
  "data": [
    {
      "postcode": "50000",
      "city":     "Kuala Lumpur",
      "state":    "Wp Kuala Lumpur",
      "state_code": "KUL"
    }
  ]
}

Full API reference available in API.md in the project repository.

Ready to get started?

Create an account, get your API token, and start searching Malaysian postcodes in minutes.