{"uid":"cap_UdfGXN4LOa24yrF9Sz7ZN","slug":"suverse-zip-code-lookup-94fbef28","name":"Suverse ZIP Code Lookup","description":"Resolve a postal code to its place names, state, and coordinates via Zippopotam, no key. Returns places with city, state, latitude, and longitude. For AI agents validating addresses and enriching postal codes.","url":"https://proxy.suverse.io/v1/data/suverse-zip-lookup","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3XDi1nmVWfWJc4rOZ7hDI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a postal code to place names, city, state, latitude, and longitude via Zippopotam, requiring no API key.","exampleAgentPrompt":"Can you look up ZIP code 90210 and tell me the city, state, and coordinates it maps to?","exampleUseCases":[{"title":"Address form validation at checkout","prompt":"A user just entered ZIP code 10001 — can you confirm what city and state that belongs to so I can auto-fill the address fields?"},{"title":"Geocoding leads for sales territory mapping","prompt":"I have a list of customer ZIP codes and need the latitude and longitude for each one — can you start by resolving 30301 to its coordinates?"},{"title":"Enriching shipping records with location data","prompt":"We have a shipment going to ZIP code 60614 and I need the city, state, and coordinates attached to the order record — can you pull that info?"}],"resultDescription":"Returns a JSON object containing an array of places for the given postal code, each with city name, state name, state abbreviation, latitude, and longitude. Also includes the country code and the postal code itself.","failureModes":["Invalid or non-existent ZIP code returns empty places array or error","Malformed request body causes a 400 Bad Request","Payment failure via x402 protocol prevents processing","Non-US postal codes may return no results or partial data","Network timeout if the upstream Zippopotam service is unavailable"],"whenToPreferThis":"Choose this endpoint when you need to resolve a US postal code to city, state, and coordinates without managing an API key. It is ideal for lightweight address enrichment and validation in agentic workflows where simplicity and low cost ($0.002/call) matter more than bulk geocoding or full address parsing. Prefer alternatives if you need full street-level geocoding, international postal code coverage, or batch processing at scale.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:48:58.558Z","isFirstParty":false}