Postal/ZIP Codes by City Lookup

Use this endpoint when you need to enumerate all ZIP/postal codes associated with a specific named city, especially for the US market. Prefer this over reverse-geocoding endpoints when the input is a city name rather than coordinates, and when you need the full set of codes rather than a single point lookup.

• City name not found or misspelled — returns empty result or error
• Invalid or unsupported country code — may return error or no results
• State abbreviation mismatch — wrong state code causes no match
• Missing required parameters (country, state, or city) — returns 400 or error JSON
• City spans ambiguous boundaries — may return incomplete set of ZIP codes
• Payment not processed (x402) — returns 402 Payment Required