{"uid":"cap_p2gGWI7lUj7a9dZxk_e1g","slug":"forgemesh-postal-code-lookup-dce06c99","name":"Forgemesh Postal Code Lookup","description":"Given a postal code and country, get back the associated place name, region or state, and geographic coordinates — covering 60+ countries including the US, Canada, UK, Germany, and France. Built for address validation and geo-enrichment steps in signup, checkout, and logistics pipelines. Cached 24 hours.","url":"https://x402.forgemesh.io/address-postal-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_-BHtbVPsube7MaKMS0Fpk","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":"Given a postal code and country code, returns the place name, region/state, and geographic coordinates for that postal code — covering 60+ countries.","exampleAgentPrompt":"What city, state, and coordinates correspond to the UK postal code SW1A 1AA? Use country code GB.","exampleUseCases":null,"resultDescription":"Returns the place name (city/town), region or state, and geographic coordinates (latitude and longitude) associated with the given postal code and country. Results are cached for 24 hours.","failureModes":["Invalid or malformed postal code returns an error or empty result","Unsupported country code returns an error","Postal code not found in database returns no match","Missing required 'code' field causes a validation error","Network or payment authorization failure prevents response"],"whenToPreferThis":"Use this endpoint when you need to resolve a raw postal code to a human-readable place name, region, and geographic coordinates — especially in signup, checkout, or logistics workflows where address enrichment or validation is needed across 60+ countries including the US, Canada, UK, Germany, and France.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:11:29.661Z","isFirstParty":false}