{"uid":"cap_hCu_WXjkIdn_N87X67nwg","slug":"fastx402-postal-place-lookup-7d2ddf7d","name":"FastX402 Postal Place Lookup","description":"200 pay-per-call tools for AI agents, from $0.001 per request in USDC on Base or Solana with x402. No account, no API key.","url":"https://fastx402.tools/postal-place-lookup?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["country","postal_code"],"properties":{"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code, lowercase, e.g. us, tr, de"},"postal_code":{"type":"string","description":"Postal code to look up, e.g. 90210 or 01000"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"places":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"region":{"type":"string"},"latitude":{"type":"string"},"longitude":{"type":"string"}}}},"country":{"type":"string"},"postal_code":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"places":[{"name":"Beverly Hills","region":"California","latitude":"34.0901","longitude":"-118.4065"}],"country":"us","postal_code":"90210"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yIBaTdhuPfecbanexOl1l","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up place names, region, and coordinates for a given postal code and country","exampleAgentPrompt":"What city and region does postal code 90210 correspond to in the US, and what are its coordinates?","exampleUseCases":[{"title":"Enrich customer address with city name","prompt":"I have a customer record with country 'de' and postal code '10115' — can you look up what city and region that corresponds to, along with the coordinates?"},{"title":"Validate delivery address region","prompt":"We received an order with zip code 33101 in the US — what place and region does that postal code map to so I can confirm the delivery area?"},{"title":"Geocode postal code for mapping","prompt":"I need the latitude and longitude for postal code 75001 in France so I can pin it on a map — can you look that up?"}],"resultDescription":"Returns a JSON object with the country, postal code, and an array of matching places. Each place includes its name, region (e.g. state or province), latitude, and longitude as strings.","failureModes":["Invalid or non-existent postal code returns an empty places array","Unsupported or misspelled country code may return an error or empty result","Missing required query parameters (country or postal_code) results in a validation error","Payment failure via x402 protocol results in a 402 response before the lookup is attempted"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, no-account postal code to place-name/coordinates lookup without setting up an API key. It is ideal for enriching records with city/region names or rough coordinates from a postal code, especially when cost per call matters and you want per-request micropayments via USDC. Prefer this over full geocoding APIs when you only have a postal code and country and don't need street-level precision.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:48:41.638Z","isFirstParty":false,"canonicalSlug":"fastx402-postal-place-lookup-7d2ddf7d"}