Postal PIN code API

Free, key-less JSON API for Indian PIN codes and post offices — no sign-up, no rate key, CORS enabled so it can be called straight from a browser.

Compatible endpoints

These match the response format of api.postalpincode.in, so existing code keeps working if you simply change the host.

1. Search by PIN code

GET https://searchpincode.ibadi.in/api/pincode/500001

curl "https://searchpincode.ibadi.in/api/pincode/500001"

[
  {
    "Message": "Number of Post office(s) found: 3",
    "Status": "Success",
    "PostOffice": [
      {
        "Name": "Hyderabad G.P.O.",
        "Description": "",
        "BranchType": "Head Post Office",
        "DeliveryStatus": "Delivery",
        "Circle": "Telangana Circle",
        "District": "Hyderabad",
        "Division": "Hyderabad GPO Division",
        "Region": "Hyderabad City Region",
        "State": "Telangana",
        "Country": "India"
      }
    ]
  }
]

2. Search by post office branch name

GET https://searchpincode.ibadi.in/api/postoffice/Kothimir

Items in this response also carry a PINCode field.

Errors

[
  {
    "Message": "No records found",
    "Status": "Error",
    "PostOffice": null
  }
]

Richer v1 endpoints

Lower-case JSON, HTTP status codes that match the outcome, and extra fields — district/state slugs, coordinates, map links and canonical page URLs.

Endpoint	Returns
`GET /api/v1/pincode/{PINCODE}`	post offices, districts, coordinates, map + page URLs
`GET /api/v1/search?q={NAME}&limit=50`	post offices matching a name prefix
`GET /api/v1/states`	all states with PIN code and post-office counts
`GET /api/v1/state/{STATE}`	districts of a state
`GET /api/v1/district/{STATE}/{DISTRICT}`	PIN codes of a district

Example: v1 PIN code lookup

GET https://searchpincode.ibadi.in/api/v1/pincode/500001

{
  "status": "success",
  "count": 3,
  "pincode": "500001",
  "state": "Telangana",
  "districts": ["Hyderabad"],
  "url": "https://searchpincode.ibadi.in/pincode/500001",
  "post_offices": [
    {
      "name": "Hyderabad G.P.O.",
      "slug": "hyderabad-g-p-o",
      "branch_type": "H.O.",
      "branch_type_full": "Head Post Office",
      "delivery_status": "Delivery",
      "latitude": 17.387993,
      "longitude": 78.47652,
      "url": "https://searchpincode.ibadi.in/pincode/500001/hyderabad-g-p-o"
    }
  ]
}

Notes

No API key and no account needed. Please cache responses rather than polling.
Responses are UTF-8 JSON with Access-Control-Allow-Origin: *. OPTIONS is answered with 204.
Unknown PIN codes return 404 (Status: Error on the compatible endpoints).
Data covers 165,574 post offices and 19,586 PIN codes.
Please set a descriptive User-Agent or link back — it helps us keep the API free.

Human-friendly pages

Every API result has a matching web page, e.g. PIN 500001. Use the JSON for apps and link to the page when you need a human-readable reference.