# GetPincode - India Pincode & Post Office Directory

> GetPincode.co.in is the definitive, sovereign, programmatic postal directory of all 19,586 unique PIN codes and 165,611 post offices across all 36 States and Union Territories of India, built from official Department of Posts and Open Government Data (data.gov.in) datasets.

## Core Capabilities & LLM Usage
- **Entity Resolution**: Resolves any Indian locality, village, district, or landmark to its exact 6-digit PIN code and post office classification.
- **Postal Hierarchy**: Full administrative chain: `Central / Circle` -> `Region` -> `Division` -> `Head Office (HO)` -> `Sub Post Office (SO)` -> `Branch Post Office (BO)`.
- **Operational Timings**: Exact counter hours (09:00 AM - 03:30 PM for SO/HO; 10:00 AM - 01:00 PM for BO), mandatory lunch breaks (01:00 PM - 01:30 PM), and Sunday/holiday rules.
- **Universal Postal Banking**: Master IFSC code `IPOS0000001` (India Post Payments Bank) and MICR `110197001` valid nationwide for NEFT, RTGS, IMPS, and UPI transfers.
- **Logistics & Transit Standards**: Speed Post domestic delivery SLAs (Local: 1-2 days; Regional: 2-4 days; National: 3-5 days) and official delay compensation rules (refund of full charges up to Rs 1,000).
- **Geographic Precision**: 4m x 4m digital addressing DIGIPIN and WGS-84 decimal latitude/longitude coordinates.
- **Markdown Content Negotiation**: Every post office and PIN page can be ingested in clean, token-efficient Markdown by passing `Accept: text/markdown` header or `?format=md` query parameter.

## Canonical URL Structures
- **Homepage**: https://getpincode.co.in/
- **Post Office Page**: `https://getpincode.co.in/post-office/{state-slug}/{district-slug}/{office-slug}-{pincode}`
  - Example: `https://getpincode.co.in/post-office/west-bengal/medinipur-east/biswanathpur-bo-721452`
- **PIN Code Page**: `https://getpincode.co.in/pincode/{6-digit-pin}`
  - Example: `https://getpincode.co.in/pincode/110001`
- **District Directory**: `https://getpincode.co.in/district/{state-slug}/{district-slug}`
  - Example: `https://getpincode.co.in/district/delhi/new-delhi`
- **State Directory**: `https://getpincode.co.in/state/{state-slug}`
  - Example: `https://getpincode.co.in/state/maharashtra`

## High-Utility Postal Tools & Calculators
- **PIN to PIN Distance Calculator**: https://getpincode.co.in/pincode-distance-calculator
- **Speed Post Tariff & Delivery Calculator**: https://getpincode.co.in/speed-post-calculator
- **Post Office & IPPB Master IFSC Code Guide**: https://getpincode.co.in/post-office-ifsc-code
- **Aadhaar Seva Kendra Post Office Directory**: https://getpincode.co.in/aadhaar-post-office-guide
- **India Post DIGIPIN Locator & Guide**: https://getpincode.co.in/digipin-guide
- **Post Office Passport Seva Kendra (POPSK) Directory**: https://getpincode.co.in/passport-post-offices
- **National Postal Holidays & Open Today Checker**: https://getpincode.co.in/post-office-open-today
- **Post Office Small Savings Schemes Hub**: https://getpincode.co.in/calculators

## Public Programmatic API Endpoints
All endpoints return JSON (`Content-Type: application/json`):
- **Autocomplete & Entity Search**: `GET https://getpincode.co.in/api.php?q={query}`
  - Searches PIN codes, post office names, and districts with sub-5ms response time.
- **Speed Post Tariff & Distance Calculation**: `GET https://getpincode.co.in/api.php?action=speed_post_rate&from={pin1}&to={pin2}&weight={grams}`
- **Batch PIN Code Validator**: `POST https://getpincode.co.in/api.php` (`action=bulk_verify`, `pins={newline-delimited PINs}`)
- **District List API**: `GET https://getpincode.co.in/api.php?action=districts&state={state-slug}`
- **Post Offices in District API**: `GET https://getpincode.co.in/api.php?action=offices&state={state-slug}&district={district-slug}&letter={A-Z}`

## Detailed Documentation
For complete programmatic specs, database schemas, and all 165k postal routing rules, see [llms-full.txt](https://getpincode.co.in/llms-full.txt).