Addresses · Source: GeoNames (CC BY 4.0) · Refreshed weekly

India PIN Code API: 155,000 Post Offices, Validated

India Post operates about 165,000 post offices; this dataset covers 155,000 of them with place name, district, state and coordinates. One PIN usually maps to several post offices, so lookups return every office under a PIN. State names are current (Puducherry, Odisha, Ladakh). Data from GeoNames under CC BY 4.0, refreshed weekly.

Request

curl "https://api.eximfetch.com/pin-codes?pinCode=600001" \
  -H "Authorization: Bearer $EXIMFETCH_API_KEY"

Response

Real records from the dataset. Every list endpoint returns the same envelope and supports page and limit.

{
  "success": true,
  "data": [
    {
      "pinCode": "600001",
      "placeName": "Chennai G.P.O.",
      "district": "Chennai",
      "state": "Tamil Nadu",
      "stateCode": "25",
      "latitude": 13.0914,
      "longitude": 80.2828
    },
    {
      "pinCode": "600001",
      "placeName": "Flower Bazaar",
      "district": "Chennai",
      "state": "Tamil Nadu",
      "stateCode": "25",
      "latitude": 13.0914,
      "longitude": 80.2828
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 1,
    "totalCount": 2,
    "limit": 25,
    "hasNextPage": false,
    "hasPrevPage": false
  }
}

More requests

  • Look up a PIN

    All post offices under 600001

    GET /pin-codes?pinCode=600001
  • Search a place

    Place or district name, prefix match

    GET /pin-codes?q=adyar
  • All PINs in a district

    Filter by names

    GET /pin-codes?state=Tamil%20Nadu&district=Chennai&limit=500
  • PIN prefix

    3 to 5 digits match as a prefix

    GET /pin-codes?pinCode=6000

Questions this dataset answers

How many PIN codes does India have?
About 19,200 distinct PINs across 155,000 post offices in this dataset. A single PIN can cover several post offices and villages.
Can I validate a PIN code with this API?
Yes: a lookup by pinCode returns the offices under it, or an empty list if the PIN does not exist. The first digit is the postal zone, so 6xxxxx is always Tamil Nadu, Kerala or nearby.