Postal Code Search JSON

Returns a list of postal codes and places for the placename/postalcode query in JSON format.

byGeoNames API (Geo Data)

700+calls

N/Alatency

Updated: Oct 28, 2026, 12:39 AM

Continue setup in your AI

Only public catalog IDs and a safe return path are handed to the Plugins page. This does not run the tool or confirm current availability, authorization, price, limits, or upstream status; those conditions are checked again before execution.

Selected tool: geonames-org.postalCodes.searchJSON.v1
Provider scope: GeoNames API (Geo Data)
Catalog updated: 2026-10-28T00:39:40.532281+00:00
Business task: Pending verification

Continue setupYou can return to this tool page if the selection is incomplete or expires.

Run on this page: Execute is the in-site test path. Continue setup is for adding the public selection to an external AI; the two paths are tracked and validated separately.

Discover -> Inspect -> Call

Call setup

Tool IDgeonames-org.postalCodes.searchJSON.v1

Request parametersJSON

Before this Call

1 credit / call

The final charge is settled from actual provider usage and will appear in Usage.

Field reference

postalcodestringRequired

postal code

postalcode_startsWithstringOptional

the first characters or letters of a postal code

placenamestringRequired

all fields : placename,postal code, country, admin name (Important:urlencoded utf8)

placename_startsWithstringOptional

the first characters of a place name

countrystringOptional

country code, ISO-3166 (optional). Default is all countries. The country parameter may occur more than once, example: country=FR&country=GP

countryBiasstringOptional

records from the countryBias are listed first

maxRowsintegerOptional

the maximal number of rows in the document returned by the service. Default is 10

stylestringOptional

verbosity of returned xml document, default = MEDIUM

operatorstringOptional

the operator 'AND' searches for all terms in the placename parameter, the operator 'OR' searches for any term, default = AND

charsetstringOptional

default is 'UTF8', defines the encoding used for the document returned by the web service.

isReducedbooleanOptional

default is 'false', when set to 'true' only the UK outer codes respectivel the NL 4-digits are returned. Attention: the default value on the commercial servers is currently set to 'true'. It will be changed later to 'false'.

eastfloatOptional

bounding box, only features within the box are returned

westfloatOptional

bounding box, only features within the box are returned

northfloatOptional

bounding box, only features within the box are returned

southfloatOptional

bounding box, only features within the box are returned

usernamestringRequired

The username for your application

Continue setup in your AI

Selected tool

geonames-org.postalCodes.searchJSON.v1

Provider scope

GeoNames API (Geo Data)

Catalog updated

2026-10-28T00:39:40.532281+00:00

Business task

Pending verification

Continue setupYou can return to this tool page if the selection is incomplete or expires.