# Postal PIN Code API: Get PIN code post offices > Looks up an Indian six-digit PIN code and lists its post offices with branch type, delivery status and postal area. Unofficial. Not affiliated with or endorsed by Postal PIN Code. - Page: https://fous.com/methods/postalpincode.in/get-pin-code - Method: `postalpincode.in/get_pin_code`, version 1 - Website: postalpincode.in - Returns: post offices with name, branch type, delivery status, district, division, region, circle, state and country - 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 | |---|---|---|---|---| | `pin_code` | string | yes | `"110001"` | Indian six-digit PIN code, for example 110001. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "pin_code": "110001" } ``` Its output: ```json { "pin_code": "110001", "post_offices": [ { "state": "Delhi", "circle": "Delhi", "region": "Delhi", "country": "India", "district": "Central Delhi", "division": "New Delhi Central", "page_url": "https://api.postalpincode.in/pincode/110001", "pin_code": "110001", "branch_type": "sub office", "delivery_status": "non-delivery", "post_office_name": "Baroda House" }, { "state": "Delhi", "circle": "Delhi", "region": "Delhi", "country": "India", "district": "Central Delhi", "division": "New Delhi Central", "page_url": "https://api.postalpincode.in/pincode/110001", "pin_code": "110001", "branch_type": "sub office", "delivery_status": "non-delivery", "post_office_name": "Bengali Market" }, { "state": "Delhi", "circle": "Delhi", "region": "Delhi", "country": "India", "district": "Central Delhi", "division": "New Delhi Central", "page_url": "https://api.postalpincode.in/pincode/110001", "pin_code": "110001", "branch_type": "sub office", "delivery_status": "non-delivery", "post_office_name": "Bhagat Singh Market" } ] } ``` ## 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/get_pin_code","input":{"pin_code":"110001"}}' ``` 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 - What post offices serve PIN code 110001 in Delhi, and are they delivery or sub offices? - Show me the branch types and delivery status of every post office under pincode 400001. - Which district, division and circle does the postal code 560034 belong to? - I need the list of post offices for PIN 682016 along with their state and region. - On postalpincode.in, look up 302001 and tell me which branch offices there deliver mail. ## Input schema ```json { "type": "object", "required": [ "pin_code" ], "properties": { "pin_code": { "type": "string", "maxLength": 6, "minLength": 6, "description": "Indian six-digit PIN code, for example 110001." } }, "additionalProperties": false } ``` ## Output schema ```json { "type": "object", "required": [ "pin_code", "post_offices" ], "properties": { "pin_code": { "type": "string", "description": "The looked-up six-digit PIN code." }, "post_offices": { "type": "array", "items": { "type": "object", "required": [ "pin_code", "post_office_name", "branch_type", "delivery_status", "district", "division", "region", "circle", "state", "country", "page_url" ], "properties": { "state": { "type": [ "string", "null" ], "description": "State or union territory." }, "circle": { "type": [ "string", "null" ], "description": "Postal circle." }, "region": { "type": [ "string", "null" ], "description": "Postal region." }, "country": { "type": [ "string", "null" ], "description": "Country." }, "district": { "type": [ "string", "null" ], "description": "District served by the post office." }, "division": { "type": [ "string", "null" ], "description": "Postal division." }, "page_url": { "type": "string", "description": "Public link to this PIN code and its offices." }, "pin_code": { "type": "string", "description": "Six-digit PIN code for this post office." }, "branch_type": { "type": [ "string", "null" ], "description": "Head office, sub office, or branch office." }, "delivery_status": { "type": [ "string", "null" ], "description": "Delivery or non-delivery." }, "post_office_name": { "type": [ "string", "null" ], "description": "Name of the post office." } }, "additionalProperties": false }, "description": "Post offices assigned to this PIN code." } }, "additionalProperties": false } ``` ## See more - [Postal PIN Code API: Search post offices by place](https://fous.com/methods/postalpincode.in/search-pin-codes.md): Finds Indian post offices matching a place name, with PIN codes, branch types, delivery statuses, districts and states. Optionally narrows by state or district. - [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. - [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. - [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. - [IPinfo API: Get IP location](https://fous.com/methods/ipinfo.io/get-ip-location.md): Finds the public location and network operator of an IPv4 or IPv6 address. Private and reserved addresses have no public location. - [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. - [police.uk API: Get neighbourhood policing team by postcode](https://fous.com/methods/police.uk/get-neighbourhood-team.md): Finds the neighbourhood policing team for a UK postcode (England, Wales, Northern Ireland) with its force, contacts, officers, priorities and upcoming events. - [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)