{"uid":"cap_iKmkt-pe3wmpZ8U_jR6nK","slug":"postal-code-lookup-api-x402-forgemesh-io-bd611a9e","name":"Postal Code Lookup API (x402.forgemesh.io)","description":"Postal code API: city, state, and coordinates for any zip/postal code in 60+ countries, and reverse place-to-codes search. For address validation, shipping, and geo-enrichment agents.","url":"https://x402.forgemesh.io/postal-code-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_tlKP1aIvTk2MlOiN9rjHw","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":"Looks up city, state, and coordinates for any postal/zip code in 60+ countries, and supports reverse place-to-codes search.","exampleAgentPrompt":"What city and state is zip code 77001 in, and can you also get me the coordinates for it? It's a US postal code.","exampleUseCases":null,"resultDescription":"Returns the city name, state/province, and geographic coordinates (latitude/longitude) associated with the given postal/zip code. May also support reverse lookup returning multiple postal codes matching a place name.","failureModes":["Invalid or non-existent postal code returns error or empty result","Unsupported country code results in no data","Missing required 'code' field causes validation error","Ambiguous place name in reverse search may return multiple or no results","Payment failure or insufficient USDC balance blocks the request"],"whenToPreferThis":"Use this endpoint when you need to resolve a zip or postal code to a city, state, and lat/lng coordinates for any of 60+ countries, especially for address validation, shipping workflows, or geo-enrichment pipelines. Prefer this over full geocoding APIs when you only have a postal code and need a fast, cheap structured lookup without a full address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:11:44.691Z","isFirstParty":false}