🌍 What is DigiPin?

DigiPin (Digital Postal Index Number) is India's revolutionary addressing system developed by the Department of Posts, Government of India. It's a game-changing technology that transforms how we identify and locate places across the country.

🎯 Key Features:

Ultra-Precise Location: Divides entire India into 3.8m × 3.8m grid squares
Unique 10-Digit Code: Each location gets a unique alphanumeric identifier
Universal Coverage: Works everywhere in India - from bustling cities to remote villages
Easy to Remember: Human-readable format like 39J-49L-L8T4
No Internet Required: Works offline once you have the code

🏠 Real-World Applications:

Postal Delivery: Precise mail and package delivery to exact locations
Emergency Services: Quick location identification for ambulance, fire, police
E-commerce: Accurate delivery addresses for online shopping
Navigation: Better than traditional addresses for GPS navigation
Government Services: Efficient service delivery and resource planning

📐 How It Works:

DigiPin uses a hierarchical grid system that progressively narrows down locations:

Level 1-3: Broad geographical regions
Level 4-6: Districts and sub-districts
Level 7-10: Precise 3.8m × 3.8m squares

Example: Dak Bhawan, New Delhi has DigiPin 39J-49L-L8T4, which pinpoints its exact location within a 3.8m × 3.8m area!

📖 Example Usage

🔗 Encode Coordinates to DigiPin

Convert latitude/longitude coordinates to DigiPin code:

# Using curl
curl "https://digipin.pratikbutani.com/api/v1/digipin/encode?lat=28.622788&lon=77.213033"

# Using browser
https://digipin.pratikbutani.com/api/v1/digipin/encode?lat=28.622788&lon=77.213033

🗺️ Decode DigiPin to Coordinates

Convert DigiPin code back to latitude/longitude coordinates:

# Using curl
curl "https://digipin.pratikbutani.com/api/v1/digipin/decode?digipin=39J49LL8T4"

# Using browser
https://digipin.pratikbutani.com/api/v1/digipin/decode?digipin=39J49LL8T4

📊 Other Endpoints

Additional utility endpoints for API information and health checks:

# Health Check
curl "https://digipin.pratikbutani.com/health"

# API Information
curl "https://digipin.pratikbutani.com/api/v1/info"

# Working Example
curl "https://digipin.pratikbutani.com/api/v1/example"

🛠️ Tech Stack

Built entirely using Warp Terminal with AI assistance - 100% without writing a single line of code manually!

Backend: Node.js serverless functions
Platform: Vercel
Development: Warp Terminal AI Agent
Language: JavaScript (ported from Dart logic)
Architecture: Serverless functions

⚠️ Disclaimer

This is NOT an official API. This is an experimental project created for testing and educational purposes only. DigiPin is an official system developed by the Department of Posts, Government of India. This API is built purely for "vibe coding" and demonstration purposes.

📍 DigiPin API