{"uid":"cap_fqXcDzzGtLDhM3EkW7u-_","slug":"forgemesh-postcode-coordinates-lookup-9b2d9cb8","name":"ForgeMesh Postcode Coordinates Lookup","description":"Resolve a postal or zip code from 60+ countries into its place name, state or region, and latitude/longitude coordinates. Unknown codes return a clean not-found result. Used for shipping estimation, tax jurisdiction lookups, and turning a customer's zip code into a point on the map for downstream geo tools.","url":"https://x402.forgemesh.io/postcode-coordinates-lookup","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"code":{"type":"string","description":"postal code, e.g. 77001"},"country":{"type":"string","description":"2-letter country, default us"}}},"responseSchema":{"type":"json","example":{"data":{"places":[{"state":"Texas","latitude":"29.7522","longitude":"-95.3595","place name":"Houston"}],"post code":"77001"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xTWuiMtuqx88qdhwuWbiF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a postal or zip code from 60+ countries into its place name, region/state, and latitude/longitude coordinates.","exampleAgentPrompt":"What city and coordinates does postal code 77001 in the US map to?","exampleUseCases":null,"resultDescription":"Returns the resolved place name, state or region, and latitude/longitude coordinates for the given postal code. If the code is not found, returns a clean not-found result rather than an error.","failureModes":["Unknown or invalid postal code returns a clean not-found result rather than an error","Unsupported country code may yield no result","Malformed postal code (wrong format for the country) may not match","Missing country field defaults to US which may be wrong for international codes"],"whenToPreferThis":"Use this endpoint when you have a raw postal or zip code and need to resolve it to a geographic place name and coordinates — especially for shipping estimation, tax jurisdiction determination, or feeding lat/lon into downstream mapping or geo tools. Covers 60+ countries, making it suitable for international commerce use cases. Prefer over full-address geocoding APIs when only a postal code is available.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:06:33.014Z","isFirstParty":false}