{"uid":"cap_UvOsUImFPKIqIff2PGpAi","slug":"suverse-postal-us-zip-lookup-9cb5e034","name":"Suverse Postal US ZIP Lookup","description":"Resolve any US ZIP code to its place name, state, and geographic coordinates. Backed by the free Zippopotam.us postal database. Pass a 5-digit ZIP and get back city, state abbreviation, latitude, and longitude.","url":"https://proxy.suverse.io/v1/data/suverse-postal-us-zip","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.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AzAxrBX5d-rSfFFLrc2Fb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a 5-digit US ZIP code to its city name, state abbreviation, latitude, and longitude using the Zippopotam.us postal database.","exampleAgentPrompt":"What city, state, and coordinates does ZIP code 90210 correspond to?","exampleUseCases":[{"title":"Enrich customer address records","prompt":"I have a customer record with ZIP code 10001 — can you fill in the city, state, and lat/lon for me?"},{"title":"Validate delivery zone coverage","prompt":"Is ZIP code 60614 in Chicago? Can you tell me the city and state it belongs to so I can check if it falls in our delivery zone?"},{"title":"Map store locations by ZIP","prompt":"I need the geographic coordinates for ZIP code 78701 so I can plot it on a map."}],"resultDescription":"Returns the place name (city), state abbreviation, latitude, and longitude corresponding to the submitted 5-digit US ZIP code, sourced from the Zippopotam.us postal database.","failureModes":["Invalid or non-existent ZIP code returns an error or empty result","Non-US postal codes are not supported","Malformed input (e.g. 4-digit or alphanumeric codes) will fail validation","Zippopotam.us database may lag on newly created ZIP codes"],"whenToPreferThis":"Choose this endpoint when you need a quick, cheap ZIP-to-location resolution for US postal codes without an API key, especially in agent workflows where you need to enrich address data with city, state, or coordinates. Prefer this over full geocoding APIs when you only have a ZIP code and need basic geospatial context rather than full address parsing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:42:21.526Z","isFirstParty":false}