{"uid":"cap_zOZ4XT3sSCcdIBu_PtwZx","slug":"us-zip-code-lookup-892208bc","name":"US ZIP Code Lookup","description":"US ZIP code to place name, state and centroid; optionally verify it belongs to a state you expect.","url":"https://geo-us.x402tookit.com/zip-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":["zip"],"properties":{"zip":{"type":"string","description":"5-digit US ZIP code"},"state":{"type":"string","description":"Optional state (abbreviation or name) to verify against"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"zip":{"type":["null","string"]},"asOf":{"type":["null","string"]},"places":{"type":["array","null"],"items":{"type":"object","properties":{"place":{"type":["null","string"]},"state":{"type":["null","string"]},"latitude":{"type":["null","number"]},"longitude":{"type":["null","number"]},"stateAbbr":{"type":["null","string"]}}}},"source":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"expectedState":{"type":["null","string"]},"matchesExpectedState":{"type":["boolean","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AJ6kB2IacAqFYSaR1ygPs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a 5-digit US ZIP code to place name, state, and centroid coordinates; optionally validates that the ZIP belongs to an expected state.","exampleAgentPrompt":"What city and state does ZIP code 10001 belong to, and can you confirm it's in New York? Give me the centroid coordinates too.","exampleUseCases":[{"title":"Validate customer ZIP at checkout","prompt":"A user entered ZIP code 75201 as their billing ZIP — can you confirm what city and state that belongs to and verify it's actually in Texas?"},{"title":"Enrich address with coordinates","prompt":"I have a list starting with ZIP 60614 — look it up and tell me the place name, state, and lat/lon centroid so I can plot it on a map."},{"title":"Catch ZIP-state mismatches in a form","prompt":"Someone filled in ZIP 90210 but selected Florida as their state — can you check whether that ZIP actually belongs to Florida or not?"}],"resultDescription":"Returns the ZIP code, the place name(s) associated with it, the full state name and abbreviation, latitude and longitude of the centroid, a source URL, and (when a state was specified) a boolean matchesExpectedState field plus a verdict and reasons explaining whether the ZIP belongs to the expected state. Also includes a freshness timestamp (asOf) and optional degraded/disclaimer flags.","failureModes":["Invalid or non-existent ZIP code returns null or empty places array","ZIP code with fewer or more than 5 digits may fail validation","State abbreviation typo may cause incorrect matchesExpectedState result","Degraded flag may indicate the underlying data source was partially unavailable","Network or payment failure (x402) may prevent the call from completing"],"whenToPreferThis":"Use this endpoint when you need to resolve a US ZIP code to a human-readable place name and state, optionally with centroid coordinates for mapping, or when you need to validate that a ZIP code belongs to a particular state. Prefer it over full address geocoding when you only have a ZIP and don't need street-level precision, and over a generic geocoder when the optional state-verification verdict is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:08:22.571Z","isFirstParty":false,"canonicalSlug":"us-zip-code-lookup-892208bc"}