Business · Live
Pincode Lookup API
From a 6-digit pincode to district, state and post offices.
What the Pincode Lookup API does
The Pincode API looks up an Indian pincode in India Post’s All India Pincode Directory and returns the district, state, postal division and circle, every post office it covers (head, sub and branch offices, with delivery status) and map coordinates where India Post publishes them.
Popular use cases
- →Auto-fill city and state in address forms
- →Check serviceability and delivery areas before checkout
- →Clean and standardise addresses in bulk
curl -X POST https://apisathi.in/gw/v1/pincode-lookup-v1/ \
-H "X-API-Key: live_xxx" \
-H "Content-Type: application/json" \
-d '{ "pincode": "302001" }'{
"pincode": "302001",
"found": true,
"district": "Jaipur",
"state": "Rajasthan",
"division": "Jaipur City Division",
"circle": "Rajasthan Circle",
"latitude": 26.91753,
"longitude": 75.80367
}Response fields returned by the Pincode Lookup API
| Field | Example |
|---|---|
| pincode | 302001 |
| found | true |
| district | Jaipur |
| state | Rajasthan |
| division | Jaipur City Division |
| circle | Rajasthan Circle |
| latitude | 26.91753 |
| longitude | 75.80367 |
Every field, error code and the full schema are in the Pincode Lookup API reference.
Call the Pincode Lookup API from Node.js or Python
const res = await fetch('https://apisathi.in/gw/v1/pincode-lookup-v1/', {
method: 'POST',
headers: { 'X-API-Key': process.env.APISATHI_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({"pincode":"302001"}),
});
const data = await res.json();import os, requests
res = requests.post(
"https://apisathi.in/gw/v1/pincode-lookup-v1/",
headers={"X-API-Key": os.environ["APISATHI_KEY"]},
json={"pincode":"302001"},
timeout=30,
)
data = res.json()Pincode Lookup API pricing
- → From ₹0.30 per successful call + 18% GST
- → Prepaid wallet from ₹200; no monthly fee, no minimum volume
- → Failed or timed-out calls are not charged
- → Bonus credit on recharges of ₹1,000 and above; GST invoice on every recharge
Start in four steps
- Create a free account — about a minute.
- Call the Pincode Lookup API with your TEST key in the sandbox, free.
- Recharge the wallet (UPI, card or netbanking) from ₹200.
- Switch to your LIVE key — the same key works for every API.
Frequently asked questions
Where does the pincode data come from?
India Post’s All India Pincode Directory, the official source for pincodes and post offices.
How much does the Pincode Lookup API cost?
The Pincode Lookup API on API Sathi starts at ₹0.30 per successful call plus 18% GST, paid from a prepaid wallet. There is no monthly fee or minimum volume, and recharges of ₹1,000 or more earn bonus credit. Live prices for every API are on the pricing page.
Can I test the Pincode Lookup API for free?
Yes. Every account gets a TEST key that calls the Pincode Lookup API in the sandbox at no cost and returns realistic sample responses, so you can finish your integration before adding money to the wallet.
Am I charged if a Pincode Lookup API call fails?
No. You pay only for successful calls. If the source is unavailable, times out or rejects the request, the amount held for that call is released straight back to your wallet.
How do I get a Pincode Lookup API key?
Sign up at apisathi.in — it takes about a minute — and create a key under API Keys. Use the TEST key in the sandbox, then recharge from ₹200 and switch to a LIVE key. The same key works for every API on API Sathi.
Related APIs
Udyam Verification API
Confirm MSME status and pull the full Udyam record.
From ₹15/call
GST Verification API
Validate any GSTIN and fetch taxpayer details in one API call.
From ₹1.20/call
Company / CIN Verification API
Resolve companies, CINs, PANs and directors from the MCA graph.
From ₹3.60/call
E-Way Bill API
Generate an e-way bill for any consignment in a single API call.
From ₹3/call
E-Invoice API (IRN Generation)
Register an invoice and get its IRN, signed QR and acknowledgement.
From ₹3/call
E-Invoice Cancellation API
Cancel a registered IRN within the window the portal allows.
From ₹3/call
Start using the Pincode Lookup API today
Sign up, recharge a prepaid wallet and generate a key in minutes. Lowest price guaranteed, no volume commitment.