# Postal PIN Code API: Search post offices by place > Finds Indian post offices matching a place name, with PIN codes, branch types, delivery statuses, districts and states. Optionally narrows by state or district. Unofficial. Not affiliated with or endorsed by Postal PIN Code. - Page: https://fous.com/methods/postalpincode.in/search-pin-codes - Method: `postalpincode.in/search_pin_codes`, version 1 - Website: postalpincode.in - Returns: post office name, PIN code, branch type, delivery status, district, state, page link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `place` | string | yes | `"Mumbai"` | Post office or locality name, for example Connaught Place. | | `max_results` | integer | no | `3` | Maximum number of matching post offices, for example 20. Default 20. | | `state_or_district` | string | no | `"Maharashtra"` | State or district to match, for example Delhi. Leave blank to search all places. Default "". | ## Output From a run on Oct 23, 2026. Its input: ```json { "place": "Mumbai", "max_results": 3, "state_or_district": "Maharashtra" } ``` Its output: ```json { "post_offices": [ { "state": "Maharashtra", "district": "Mumbai", "pin_code": "400099", "page_link": "https://api.postalpincode.in/postoffice/Airport%20%28Mumbai%29", "branch_type": "sub office", "delivery_status": "Non-Delivery", "post_office_name": "Airport (Mumbai)" }, { "state": "Maharashtra", "district": "Mumbai", "pin_code": "400004", "page_link": "https://api.postalpincode.in/postoffice/Ambewadi%20%28Mumbai%29", "branch_type": "sub office", "delivery_status": "Non-Delivery", "post_office_name": "Ambewadi (Mumbai)" }, { "state": "Maharashtra", "district": "Mumbai", "pin_code": "400053", "page_link": "https://api.postalpincode.in/postoffice/Azad%20Nagar%20%28Mumbai%29", "branch_type": "sub office", "delivery_status": "Delivery", "post_office_name": "Azad Nagar (Mumbai)" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"postalpincode.in/search_pin_codes","input":{"place":"Mumbai","max_results":3,"state_or_district":"Maharashtra"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find all post offices named Connaught Place with their PIN codes and delivery status - Which post office serves Koramangala in Bangalore? Show branch type and district - List up to 10 post offices matching Andheri in Maharashtra - Look up PIN codes for post offices called Civil Lines on postalpincode.in - Show head and sub post offices matching Salt Lake in West Bengal with their districts ## Input schema ```json { "type": "object", "required": [ "place" ], "properties": { "place": { "type": "string", "minLength": 1, "description": "Post office or locality name, for example Connaught Place." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of matching post offices, for example 20." }, "state_or_district": { "type": "string", "default": "", "description": "State or district to match, for example Delhi. Leave blank to search all places." } } } ``` ## Output schema ```json { "type": "object", "required": [ "post_offices" ], "properties": { "post_offices": { "type": "array", "items": { "type": "object", "required": [ "post_office_name", "pin_code", "page_link" ], "properties": { "state": { "type": "string" }, "district": { "type": "string" }, "pin_code": { "type": "string" }, "page_link": { "type": "string" }, "branch_type": { "type": "string" }, "delivery_status": { "type": "string" }, "post_office_name": { "type": "string" } } }, "description": "Matching post offices in the order returned by the service." } } } ``` ## See more - [Postal PIN Code API: Get PIN code post offices](https://fous.com/methods/postalpincode.in/get-pin-code.md): Looks up an Indian six-digit PIN code and lists its post offices with branch type, delivery status and postal area. - [Zippopotam.us API: Search postal codes](https://fous.com/methods/zippopotam.us/search-postal-codes.md): Finds postal codes, place names and coordinates for a town and state or region in a country covered by Zippopotam.us. - [Postcodes.io API: List nearby postcodes](https://fous.com/methods/postcodes.io/list-nearby-postcodes.md): Lists UK postcodes nearest to a postcode or named place, with distance, ward, council and coordinates. For places sharing a name, a city or town is preferred. - [Zippopotam.us API: Get postal code](https://fous.com/methods/zippopotam.us/get-postal-code.md): Looks up the places, regions and coordinates for a postal code in a supported country on Zippopotam.us. - [OpenStreetMap API: Search places](https://fous.com/methods/openstreetmap.org/search-places.md): Finds named places or kinds of places in a city or area, in search order, using OpenStreetMap Nominatim. Results may be fewer than requested. Data © OpenStreetMap contributors (ODbL). - [Postcodes.io API: Get postcode details](https://fous.com/methods/postcodes.io/get-postcode.md): Looks up a UK postcode on Postcodes.io, including its location, administrative areas and whether it is still in use. Retired postcodes return location and retirement year only. - [Google API: Get place](https://fous.com/methods/google.com/get-place.md): Looks up a public Google Maps place by name and location and returns its profile: address, rating, hours, phone, website and photos. - [U.S. Census Bureau API: Get address details](https://fous.com/methods/census.gov/get-address-details.md): Matches a US street address and returns its city or place, county, state, ZIP code, census tract, congressional and state legislative districts, coordinates and FIPS codes. Districts follow the Census Geocoder's current geography vintage and may differ from sitting representation. - [All Postal PIN Code methods](https://fous.com/methods/postalpincode.in.md)