{"uid":"cap_G2-0g3bVYO8WFJFm6wGQE","slug":"postal-zip-code-lookup-city-state-coordinates-60-countries-9d80b861","name":"Postal/ZIP Code Lookup: City, State & Coordinates (60+ Countries)","description":"Postal/ZIP code lookup: city, state, coordinates (60+ countries) — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/geo/postal-code?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"country":{"type":"string","description":"optional ISO-2, default us"},"postal_code":{"type":"string","description":"required"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"postal-lookup","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.001,"receipt_id":"g402-<16hex>"},"sources":[{"ok":true,"name":"<source>"}],"limitations":"<text>","generated_at":"<iso time>","evidence_hash":"sha256:<64hex>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AmkEeq4LgyWsFRqAIsKhq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","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 to city name, state/region, and geographic coordinates for 60+ countries worldwide.","exampleAgentPrompt":"What city, state, and coordinates does ZIP code 90210 correspond to in the US?","exampleUseCases":[{"title":"Shipping address validation for e-commerce","prompt":"I have a customer order with ZIP code 94103 in the US — can you tell me what city and state that maps to so I can verify their shipping address?"},{"title":"International postal code resolution","prompt":"What city and region does the postal code EC1A 1BB belong to in the UK, and what are its coordinates?"},{"title":"Enriching user signup data with location","prompt":"A new user signed up with postal code 10001 and country code US — what city and state should I display on their profile?"}],"resultDescription":"Returns the city name, state or region, and geographic coordinates (latitude/longitude) associated with the given postal code and country. Covers 60+ countries worldwide.","failureModes":["Invalid or non-existent postal code returns an error or empty result","Unsupported country code returns an error","Missing required postal_code parameter causes a validation error","Malformed country ISO-2 code may return unexpected results"],"whenToPreferThis":"Choose this endpoint when you need a fast, low-cost postal/ZIP code to city/state/coordinates lookup across a broad range of countries (60+) and want pay-per-call pricing via x402 without API key management. Ideal for enriching address data, validating user input, or adding geographic context to records.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:55:47.573Z","isFirstParty":false,"canonicalSlug":"postal-zip-code-lookup-city-state-coordinates-60-countries-9d80b861"}