{"uid":"cap_Hsalt1dI8p8vkkNPAgpof","slug":"suverse-us-city-zip-code-lookup-77a43a9d","name":"Suverse US City ZIP Code Lookup","description":"Given a US state code and a city name, return every ZIP code in that city with coordinates. Useful for territory mapping and address validation. Free Zippopotam.us postal data.","url":"https://proxy.suverse.io/v1/data/suverse-postal-us-city-zips","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.06","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.06/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_8xcwGz2kOYOEo_mjcWBgo","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":"Returns all ZIP codes with coordinates for a given US city and state code, sourced from Zippopotam.us postal data.","exampleAgentPrompt":"Can you get me all the ZIP codes and their coordinates for Denver, Colorado? I need them for territory mapping.","exampleUseCases":[{"title":"Delivery zone setup for e-commerce","prompt":"I need all the ZIP codes with their lat/lon coordinates for Nashville, Tennessee so I can set up our delivery zone coverage."},{"title":"Address validation for a checkout form","prompt":"Can you pull every ZIP code that belongs to Austin, Texas? I want to validate that customer-entered ZIP codes actually match the city they claim."},{"title":"Sales territory mapping by city","prompt":"Get me all the ZIP codes and coordinates for Seattle, Washington — I'm building a sales territory map and need to know which ZIPs fall within the city."}],"resultDescription":"A list of all ZIP codes belonging to the specified US city and state, each accompanied by geographic coordinates (latitude and longitude), sourced from Zippopotam.us free postal data.","failureModes":["Invalid or unrecognized state code returns an error or empty result","City name misspelling or non-existent city returns empty or null results","Cities spanning multiple counties or with ambiguous names may return incomplete results","Rate limiting or payment failure ($0.06 USDC x402) blocks the request","Non-US locations are not supported by this endpoint"],"whenToPreferThis":"Use this endpoint when you need a comprehensive list of all ZIP codes within a specific US city along with their geographic coordinates. It is ideal for territory mapping, delivery zone configuration, and address validation workflows where you need city-level postal granularity. Prefer this over manual lookups or geocoding APIs when you need the full ZIP code inventory for a city rather than a single coordinate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:47:28.444Z","isFirstParty":false}