{"uid":"cap_SPMhbXELOGUBKzFpOTBr3","slug":"2s-io-postal-code-geocoder-adb8b05c","name":"2s.io Postal Code Geocoder","description":"Resolve a postal/ZIP code to its place name(s), administrative divisions, and coordinates. Pass `postalCode` and a 2-letter `country` (default US). Returns each matching locality: place, admin1 (state/province name + code), admin2 (county/district), and lat/lon. International — covers major markets (US, GB, CA, DE, FR, AU, NL, ES, IT, CH, SE, MX). Use it to normalize and enrich addresses, derive the state/county for a ZIP, or geolocate a postal code in an ETL pipeline.","url":"https://2s.io/api/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","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["postalCode"],"properties":{"country":{"type":"string","description":"2-letter ISO country code (default US)."},"postalCode":{"type":"string","description":"Postal / ZIP code."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"country":"US","postalCode":"94103"}}},"response":{"data":{"ok":true,"items":[{"place":"San Francisco","admin1":{"code":"CA","name":"California"},"admin2":{"code":"075","name":"City and County of San Francisco"},"coords":{"lat":37.7725,"lon":-122.4147},"country":"US","postalCode":"94103"}],"total":1,"source":{"url":"https://www.geonames.org","license":"CC BY 4.0 — attribute GeoNames.","provider":"GeoNames"}},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"geo.postal","settlement":{"txHash":"0xd9cb7213bc0dba64d6d66d71bc18627ea94ec8ca756bd1bbdbf579e103413977","network":"eip155:8453","success":true}}}},"exampleRequest":{"country":"US","postalCode":"94103"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_co-VpuTH4IkC1wdztryZi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a postal/ZIP code and country to place names, administrative divisions (state/province, county), and coordinates","exampleAgentPrompt":"What city, state, and county does ZIP code 94103 correspond to in the US — and can you give me its coordinates too?","exampleUseCases":null,"resultDescription":"Returns one or more matching localities for the postal code, each with: place name, admin1 (state or province name and code), admin2 (county or district), and latitude/longitude coordinates. International coverage includes US, GB, CA, DE, FR, AU, NL, ES, IT, CH, SE, and MX.","failureModes":["Unknown or invalid postal code returns empty results or 404","Unsupported country code returns an error or empty response","Missing required postalCode parameter returns a 400 bad request","Some postal codes map to multiple localities, returning an array","Non-numeric or malformed ZIP codes may return no match"],"whenToPreferThis":"Use this endpoint when you need to resolve or enrich a postal/ZIP code with human-readable place names, state/province codes, county information, or geographic coordinates. Ideal for ETL pipelines, address normalization, deriving state from ZIP without a full geocoding stack, or geolocating users from a postal code. Covers major international markets beyond just the US.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:46:09.696Z","isFirstParty":false}