# Zippopotam.us API: Get postal code > Looks up the places, regions and coordinates for a postal code in a supported country on Zippopotam.us. Unofficial. Not affiliated with or endorsed by Zippopotam.us. - Page: https://fous.com/methods/zippopotam.us/get-postal-code - Method: `zippopotam.us/get_postal_code`, version 1 - Website: zippopotam.us - Returns: country, postal code, places with state and coordinates - 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 | |---|---|---|---|---| | `country` | string | no | | Country name or two-letter country code, such as Germany or DE. Defaults to United States. Default "United States". | | `postal_code` | string | yes | `"90210"` | Postal code to look up, such as 90210 or 10115. | ## Output From a run on Oct 23, 2026. Its input: ```json { "postal_code": "90210" } ``` Its output: ```json { "places": [ { "state": "California", "latitude": 34.0901, "page_url": "https://api.zippopotam.us/us/90210", "longitude": -118.4065, "place_name": "Beverly Hills", "state_abbreviation": "CA" } ], "country": "United States", "postal_code": "90210" } ``` ## 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":"zippopotam.us/get_postal_code","input":{"postal_code":"90210"}}' ``` 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 city and state does ZIP code 73301 belong to, and what are its coordinates? - Find the places and latitude/longitude for German postal code 10115. - Look up postal code 90210 in the US and tell me the state and coordinates of each place. - I need the town and region for the Canadian postal code M5V, along with its coordinates. - Using zippopotam.us, what locations are tied to postal code 02101 in the United States? ## Input schema ```json { "type": "object", "required": [ "postal_code" ], "properties": { "country": { "type": "string", "default": "United States", "description": "Country name or two-letter country code, such as Germany or DE. Defaults to United States." }, "postal_code": { "type": "string", "description": "Postal code to look up, such as 90210 or 10115." } }, "additionalProperties": false } ``` ## Output schema ```json { "type": "object", "required": [ "country", "postal_code", "places" ], "properties": { "places": { "type": "array", "items": { "type": "object", "required": [ "place_name", "state", "state_abbreviation", "latitude", "longitude", "page_url" ], "properties": { "state": { "type": [ "string", "null" ], "description": "State or region name." }, "latitude": { "type": [ "number", "null" ], "description": "Latitude in decimal degrees." }, "page_url": { "type": "string", "description": "Link to this postal code on Zippopotam.us." }, "longitude": { "type": [ "number", "null" ], "description": "Longitude in decimal degrees." }, "place_name": { "type": [ "string", "null" ], "description": "Place name." }, "state_abbreviation": { "type": [ "string", "null" ], "description": "State or region abbreviation." } }, "additionalProperties": false }, "description": "Places using this postal code." }, "country": { "type": "string", "description": "Country name." }, "postal_code": { "type": "string", "description": "Postal code looked up." } }, "additionalProperties": false } ``` ## See more - [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: 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. - [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. - [OpenStreetMap API: Get coordinates for an address](https://fous.com/methods/openstreetmap.org/get-coordinates.md): Finds map coordinates and address details for an address or place on OpenStreetMap, optionally restricted to a country. - [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. - [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. - [USPS API: Estimate postage](https://fous.com/methods/usps.com/estimate-postage.md): Estimates domestic USPS Post Office retail postage between two ZIP Codes for a letter, large envelope, package or flat-rate packaging, by weight and mailing date. Media Mail is left out; a zero-weight letter counts as one ounce. Prices are retail, cheapest first, with each service's estimated delivery. - [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. - [All Zippopotam.us methods](https://fous.com/methods/zippopotam.us.md)