{"uid":"cap_DsEOPfwCLdMzDY85oq2C8","slug":"greeneris-postal-code-geo-lookup-cc494253","name":"Greeneris Postal Code Geo Lookup","description":"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.","url":"https://data.greeneris.io/v1/geo/postal","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"city":{"type":"string","description":"City name (reverse mode, with state)"},"code":{"type":"string","description":"Postal code to resolve (forward mode)"},"state":{"type":"string","description":"State/region name or code (reverse mode, with city)"},"country":{"type":"string","description":"2-letter ISO country code, e.g. us, fr, de"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"mode":"forward","count":1,"found":true,"places":[{"name":"Beverly Hills","state":"California","latitude":34.0901,"longitude":-118.4065,"state_code":"CA"}],"source":"Zippopotam.us, data from GeoNames (CC BY 4.0, attribution required)","country":"United States","postal_code":"90210","country_code":"US"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Tyrsat8bDKWIhOhgp-wUM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a postal code to city/state/coordinates (forward) or finds a postal code for a city+state pair (reverse) for a given country","exampleAgentPrompt":"What city and state does the postal code 90210 correspond to in the US, and what are its coordinates?","exampleUseCases":null,"resultDescription":"Returns a JSON object with mode (forward or reverse), found flag, count, and an array of matching places each containing city name, state, state code, latitude, longitude, plus country name, country code, postal code, and the data source attribution.","failureModes":["Missing required 'country' query parameter returns 400 error","Invalid or nonexistent postal code returns found:false with empty places array","Unsupported country code may return no results","HTTP 402 payment required if x402 payment not included or invalid","Malformed country code (not ISO 2-letter) may return error","Reverse mode requires both city and state parameters; missing one may yield no results"],"whenToPreferThis":"Use this endpoint when you need to resolve a postal code to geographic coordinates and city/state metadata, or perform a reverse lookup from city+state to postal code, for countries supported by GeoNames/Zippopotam data. Prefer this over geocoding APIs that require full addresses when you only have a zip/postal code. Particularly useful for address enrichment, delivery zone validation, and location normalization pipelines. At $0.001 per call with no account required, it is well-suited for high-volume agent workflows using x402 pay-per-call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:52:27.992Z","isFirstParty":false}