{"openapi":"3.1.0","info":{"title":"US Geography","version":"1.0.0","description":"Geocode US addresses, reverse geocode, districts, metro areas, ZIP lookup, state FIPS and GEOID parsing. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"US Geography: Geocode US addresses, reverse geocode, districts, metro areas, ZIP lookup, state FIPS and GEOID parsing. US Geography turns US places into structured facts: geocode an address to coordinates and Census codes (/geocode-address), find what is at a coordinate (/reverse-geocode), which congressional and legislative districts cover an address (/political-districts), which metro area, urban area and county (/metro-area), a ZIP code lookup with optional state check (/zip-lookup), state names, abbreviations and FIPS codes (/us-state-info), Census GEOID parsing (/geoid-parse) and distance between two points (/coord-distance). Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://geo-us.x402tookit.com"}],"paths":{"/coord-distance":{"get":{"operationId":"coord_distance","summary":"Great-circle (haversine) distance between two coordinates in km, miles and nautical miles, with bearing and midpoint.","description":"Great-circle (haversine) distance between two coordinates in km, miles and nautical miles, with bearing and midpoint.","tags":["distance","haversine","geography"],"parameters":[{"name":"lat1","in":"query","required":true,"description":"Latitude of point 1","schema":{"type":"number"}},{"name":"lon1","in":"query","required":true,"description":"Longitude of point 1","schema":{"type":"number"}},{"name":"lat2","in":"query","required":true,"description":"Latitude of point 2","schema":{"type":"number"}},{"name":"lon2","in":"query","required":true,"description":"Longitude of point 2","schema":{"type":"number"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"meters":{"type":["null","number"]},"kilometers":{"type":["null","number"]},"miles":{"type":["null","number"]},"nauticalMiles":{"type":["null","number"]},"initialBearingDegrees":{"type":["null","number"]},"compass":{"type":["null","string"]},"midpoint":{"type":["null","object"],"properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"3935.8 km (2445.6 mi) at initial bearing 273.7 degrees (W).","reasons":["Great-circle distance on a spherical Earth; real travel distance is longer."],"meters":3935751.7,"kilometers":3935.752,"miles":2445.563,"nauticalMiles":2125.136,"initialBearingDegrees":273.69,"compass":"W","midpoint":{"lat":39.51031,"lon":-97.16013},"degraded":false,"notChecked":["road, rail or flight-path distance","the ellipsoid (spherical Earth: error up to about 0.5%)","…1 more"],"source":"computed locally","asOf":"2026-10-11T04:46:52.819Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/coord-distance"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/coord-distance"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/coord-distance"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/coord-distance"}}]}}},"/geocode-address":{"get":{"operationId":"geocode_address","summary":"Geocode a US street address: normalized address, latitude and longitude, state, county and tract codes, with match quality.","description":"Geocode a US street address: normalized address, latitude and longitude, state, county and tract codes, with match quality.","tags":["geocoding","address","census"],"parameters":[{"name":"address","in":"query","required":true,"description":"US street address with city and state or ZIP","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"matchedAddress":{"type":["null","string"]},"latitude":{"type":["null","number"]},"longitude":{"type":["null","number"]},"matches":{"type":["null","number"]},"components":{"type":["null","object"],"properties":{"number":{"type":["null","string"]},"street":{"type":["null","string"]},"city":{"type":["null","string"]},"state":{"type":["null","string"]},"zip":{"type":["null","string"]}}},"stateFips":{"type":["null","string"]},"countyFips":{"type":["null","string"]},"county":{"type":["null","string"]},"tractGeoid":{"type":["null","string"]},"place":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"MATCHED","summary":"1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500: 38.89870, -77.03519, District of Columbia, DC.","reasons":["Single match.","Coordinates are interpolated along the street segment, not a surveyed rooftop point."],"matchedAddress":"1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500","latitude":38.898702605245,"longitude":-77.035189204737,"matches":1,"components":{"number":"1600","street":"PENNSYLVANIA AVE NW","city":"WASHINGTON","state":"DC","zip":"20500"},"stateFips":"11","countyFips":"11001","county":"District of Columbia","tractGeoid":"11001980000","place":"Washington city","degraded":false,"notChecked":["whether the address is deliverable by the Postal Service","rooftop accuracy (Census uses street address ranges)","…2 more"],"source":"US Census Bureau Geocoder. This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.","sourceUrl":"https://geocoding.geo.census.gov/geocoder","asOf":"2026-10-11T04:46:53.582Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/geocode-address"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/geocode-address"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/geocode-address"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/geocode-address"}}]}}},"/geoid-parse":{"get":{"operationId":"geoid_parse","summary":"Parse a Census GEOID into state, county, tract, block group and block codes and name its geographic level.","description":"Parse a Census GEOID into state, county, tract, block group and block codes and name its geographic level.","tags":["census","geoid","fips"],"parameters":[{"name":"geoid","in":"query","required":true,"description":"Numeric GEOID of 2, 5, 11, 12 or 15 digits","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"level":{"type":["null","string"]},"state":{"type":["null","object"],"properties":{"fips":{"type":["null","string"]},"name":{"type":["null","string"]},"abbr":{"type":["null","string"]}}},"county":{"type":["null","string"]},"countyGeoid":{"type":["null","string"]},"tract":{"type":["null","string"]},"tractLabel":{"type":["null","string"]},"blockGroup":{"type":["null","string"]},"block":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"PARSED","summary":"block GEOID 110019800001034: District of Columbia, county 001, tract 9800, block group 1, block 1034.","reasons":[],"level":"block","state":{"fips":"11","name":"District of Columbia","abbr":"DC"},"county":"001","countyGeoid":"11001","tract":"980000","tractLabel":"9800","blockGroup":"1","block":"1034","degraded":false,"notChecked":["whether the code exists in the current Census vintage","county names (needs the Census gazetteer)","…1 more"],"source":"computed locally","asOf":"2026-10-11T04:46:53.843Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/geoid-parse"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/geoid-parse"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/geoid-parse"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/geoid-parse"}}]}}},"/metro-area":{"get":{"operationId":"metro_area","summary":"Metro area context for a US address or lat/lon: metro or micropolitan area, urban area, county and urban or rural setting.","description":"Metro area context for a US address or lat/lon: metro or micropolitan area, urban area, county and urban or rural setting.","tags":["metro","cbsa","urban","census"],"parameters":[{"name":"address","in":"query","required":false,"description":"US street address (or give lat and lon)","schema":{"type":"string"}},{"name":"lat","in":"query","required":false,"description":"Latitude (with lon)","schema":{"type":"number"}},{"name":"lon","in":"query","required":false,"description":"Longitude (with lat)","schema":{"type":"number"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"county":{"type":["null","string"]},"countyGeoid":{"type":["null","string"]},"state":{"type":["null","string"]},"metroOrMicroArea":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"code":{"type":["null","string"]}}},"combinedStatisticalArea":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"code":{"type":["null","string"]}}},"urbanArea":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"code":{"type":["null","string"]}}},"setting":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"IN_METRO","summary":"District of Columbia, DC: in the Washington-Arlington-Alexandria, DC-VA-MD-WV Metro Area; urban area Washington--Arlington, DC--VA--MD Urban Area.","reasons":["Part of the Washington-Baltimore-Arlington, DC-MD-VA-WV-PA CSA."],"county":"District of Columbia","countyGeoid":"11001","state":"District of Columbia","metroOrMicroArea":{"name":"Washington-Arlington-Alexandria, DC-VA-MD-WV Metro Area","code":"47900"},"combinedStatisticalArea":{"name":"Washington-Baltimore-Arlington, DC-MD-VA-WV-PA CSA","code":"548"},"urbanArea":{"name":"Washington--Arlington, DC--VA--MD Urban Area","code":"92242"},"setting":"urban cluster or urban area","degraded":false,"notChecked":["population or demographics","commuting zones","…1 more"],"source":"US Census Bureau Geocoder. This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.","sourceUrl":"https://geocoding.geo.census.gov/geocoder","asOf":"2026-10-11T04:46:54.454Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/metro-area"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/metro-area"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/metro-area"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/metro-area"}}]}}},"/political-districts":{"get":{"operationId":"political_districts","summary":"Congressional and state legislative (upper and lower) districts covering a US address, with district codes and the state.","description":"Congressional and state legislative (upper and lower) districts covering a US address, with district codes and the state.","tags":["districts","congress","census","civic"],"parameters":[{"name":"address","in":"query","required":true,"description":"US street address with city and state or ZIP","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"matchedAddress":{"type":["null","string"]},"state":{"type":["null","string"]},"congressionalDistrict":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"geoid":{"type":["null","string"]},"code":{}}},"stateSenateDistrict":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"geoid":{"type":["null","string"]}}},"stateHouseDistrict":{},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"DISTRICTS_FOUND","summary":"1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500: Congressional Delegate District (at Large); state senate Ward 2; state house n/a.","reasons":["Districts come from the Census Bureau's current boundary files and may lag a redistricting."],"matchedAddress":"1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500","state":"District of Columbia","congressionalDistrict":{"name":"Delegate District (at Large)","geoid":"1198","code":null},"stateSenateDistrict":{"name":"Ward 2","geoid":"11002"},"stateHouseDistrict":null,"degraded":false,"notChecked":["who currently holds the seat","school-board, city-council or precinct boundaries","…1 more"],"source":"US Census Bureau Geocoder. This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.","sourceUrl":"https://geocoding.geo.census.gov/geocoder","asOf":"2026-10-11T04:46:55.048Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0500"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/political-districts"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/political-districts"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/political-districts"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/political-districts"}}]}}},"/reverse-geocode":{"get":{"operationId":"reverse_geocode","summary":"Census geography at a US coordinate: state, county, tract, block, city or place, with GEOIDs for joining Census data.","description":"Census geography at a US coordinate: state, county, tract, block, city or place, with GEOIDs for joining Census data.","tags":["geocoding","census","reverse-geocode"],"parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"number"}},{"name":"lon","in":"query","required":true,"description":"Longitude","schema":{"type":"number"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"state":{"type":["null","string"]},"stateAbbr":{"type":["null","string"]},"stateFips":{"type":["null","string"]},"county":{"type":["null","string"]},"countyGeoid":{"type":["null","string"]},"place":{"type":["null","string"]},"placeGeoid":{"type":["null","string"]},"countySubdivision":{"type":["null","string"]},"zcta":{"type":["null","string"]},"schoolDistrict":{"type":["null","string"]},"tractGeoid":{"type":["null","string"]},"blockGeoid":{"type":["null","string"]},"blockGroupGeoid":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"LOCATED","summary":"38.8977, -77.0365 is in Washington city, District of Columbia, District of Columbia.","reasons":["Census tract 9800 (GEOID 11001980000)."],"lat":38.8977,"lon":-77.0365,"state":"District of Columbia","stateAbbr":"DC","stateFips":"11","county":"District of Columbia","countyGeoid":"11001","place":"Washington city","placeGeoid":"1150000","countySubdivision":"Washington city","zcta":"20006","schoolDistrict":"District of Columbia Public Schools","tractGeoid":"11001980000","blockGeoid":"110019800001034","blockGroupGeoid":"110019800001","degraded":false,"notChecked":["street address (this returns Census areas, not an address)","points outside the US and its territories","…1 more"],"source":"US Census Bureau Geocoder. This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.","sourceUrl":"https://geocoding.geo.census.gov/geocoder","asOf":"2026-10-11T04:46:55.638Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/reverse-geocode"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/reverse-geocode"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/reverse-geocode"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/reverse-geocode"}}]}}},"/us-state-info":{"get":{"operationId":"us_state_info","summary":"Look up a US state or territory by name, postal abbreviation or FIPS code: all three, region, division and capital.","description":"Look up a US state or territory by name, postal abbreviation or FIPS code: all three, region, division and capital.","tags":["states","fips","reference"],"parameters":[{"name":"state","in":"query","required":true,"description":"Name, abbreviation or FIPS, e.g. Ohio, OH or 39","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"abbr":{"type":["null","string"]},"name":{"type":["null","string"]},"fips":{"type":["null","string"]},"region":{"type":["null","string"]},"division":{"type":["null","string"]},"capital":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"Ohio: OH, FIPS 39, Midwest region (East North Central), capital Columbus.","reasons":[],"abbr":"OH","name":"Ohio","fips":"39","region":"Midwest","division":"East North Central","capital":"Columbus","degraded":false,"notChecked":["foreign countries","county codes (use /geoid-parse for GEOIDs)"],"source":"computed locally","asOf":"2026-10-11T04:46:55.889Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/us-state-info"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/us-state-info"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/us-state-info"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/us-state-info"}}]}}},"/zip-lookup":{"get":{"operationId":"zip_lookup","summary":"US ZIP code to place name, state and centroid; optionally verify it belongs to a state you expect.","description":"US ZIP code to place name, state and centroid; optionally verify it belongs to a state you expect.","tags":["zip","postal","geography"],"parameters":[{"name":"zip","in":"query","required":true,"description":"5-digit US ZIP code","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Optional state (abbreviation or name) to verify against","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"zip":{"type":["null","string"]},"places":{"type":["array","null"],"items":{"type":"object","properties":{"place":{"type":["null","string"]},"state":{"type":["null","string"]},"stateAbbr":{"type":["null","string"]},"latitude":{"type":["null","number"]},"longitude":{"type":["null","number"]}}}},"expectedState":{"type":["null","string"]},"matchesExpectedState":{"type":["boolean","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"STATE_MATCH","summary":"90210: Beverly Hills, CA; matches CA.","reasons":[],"zip":"90210","places":[{"place":"Beverly Hills","state":"California","stateAbbr":"CA","latitude":34.0901,"longitude":-118.4065}],"expectedState":"CA","matchesExpectedState":true,"degraded":false,"notChecked":["ZIP boundaries (a ZIP is a mail route, not an area; centroids are approximate)","PO-box-only and unique-organization ZIPs may be missing","…1 more"],"source":"Zippopotam.us","sourceUrl":"https://zippopotam.us","asOf":"2026-10-11T04:46:56.222Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/zip-lookup"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/zip-lookup"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/zip-lookup"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://geo-us.x402tookit.com/zip-lookup"}}]}}}}}