Postal code lookup worldwide: code -> city/state/lat/lon, or city -> codes

Postal code resolution for ~60 countries via Zippopotam.us (GeoNames data, CC BY 4.0). Forward: ?country=us&code=90210 -> place names, state, lat/lon. Reverse: ?country=us&state=ca&city=beverly hills -> matching postal codes with coordinates. Unknown codes return found=false (an explicit validation verdict). Cached 30 days.

get/v1/geo/postal

Request

  • Base URL: https://data.greeneris.io (the document declares no server; this is the origin it was published from)
  • URL: https://data.greeneris.io/v1/geo/postal
  • Auth: none declared

Query parameters

countrystring required

2-letter ISO country code, e.g. us, fr, de

codestring

Postal code to resolve (forward mode)

statestring

State/region name or code (reverse mode, with city)

citystring

City name (reverse mode, with state)

Response

Successful response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.