india-post-pincode

Offline India Post pincode → district / state / coordinates lookup for ~19.5k PIN codes.

Works with modern bundlers and Node via ESM and CommonJS.

Install

npm install india-post-pincode
# or
pnpm add india-post-pincode
# or
yarn add india-post-pincode

Usage

ESM

import {
  lookupPincode,
  isValidIndianPincode,
  normalizePincode,
  getStates,
} from 'india-post-pincode'

lookupPincode('400001')
// {
//   pincode: '400001',
//   district: 'Mumbai',
//   state: 'Maharashtra',
//   latitude: 18.935871,
//   longitude: 72.834092
// }

isValidIndianPincode('110001') // true
isValidIndianPincode('000000') // false
normalizePincode('400 001')   // '400001'

CommonJS

const { lookupPincode, isValidIndianPincode } = require('india-post-pincode')

API

| Function | Description | |---|---| | lookupPincode(value) | { pincode, district, state, latitude, longitude } \| null | | isValidIndianPincode(value) | boolean — known 6-digit PIN | | normalizePincode(value) | digits only, max 6 | | getStates() | sorted state / UT names | | getDistricts() | sorted district names | | getPincodeCount() | number of unique PINs |

Data

Aggregated from India Post office records (one row per pincode):

• District / state: majority vote across offices (title-cased)
• Coordinates: mean of valid office lat/long for that PIN

Regenerate from a CSV:

node scripts/build-data.mjs /path/to/india-post-offices.csv
npm run build

Expected columns: pincode, district, statename, latitude, longitude, officetype.

License

MIT