---
title: "Postal code lookup worldwide: code -> city/state/lat/lon, or city -> codes"
method: GET
path: "/v1/geo/postal"
---

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

`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

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.

## Query parameters

- `country` string, required
- `code` string
- `state` string
- `city` string

## Response `200`

Successful response

- unknown

---

[API](https://skmtc.dev/greeneris/apis/eu-verify.md) · [All operations](https://skmtc.dev/greeneris/apis/eu-verify/llms.txt) · [OpenAPI document](https://skmtc.dev/greeneris/apis/eu-verify/revisions/766cf4a67d8f?raw)