{"uid":"cap_T7lGE1GNLsE-hjpC7ODtA","slug":"us-geography-reverse-geocode-fbe37b65","name":"US Geography Reverse Geocode","description":"Census geography at a US coordinate: state, county, tract, block, city or place, with GEOIDs for joining Census data.","url":"https://geo-us.x402tookit.com/reverse-geocode?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":["lat","lon"],"properties":{"lat":{"type":"number","description":"Latitude"},"lon":{"type":"number","description":"Longitude"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"asOf":{"type":["null","string"]},"zcta":{"type":["null","string"]},"place":{"type":["null","string"]},"state":{"type":["null","string"]},"county":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"sourceUrl":{"type":["null","string"]},"stateAbbr":{"type":["null","string"]},"stateFips":{"type":["null","string"]},"blockGeoid":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"placeGeoid":{"type":["null","string"]},"tractGeoid":{"type":["null","string"]},"countyGeoid":{"type":["null","string"]},"schoolDistrict":{"type":["null","string"]},"blockGroupGeoid":{"type":["null","string"]},"countySubdivision":{"type":["null","string"]}}}}}}},"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_UPn19ugqp7U-V3oo1lb20","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":"Returns Census geographic identifiers (state, county, tract, block, place, ZCTA) for a given US latitude/longitude coordinate.","exampleAgentPrompt":"What Census tract, county, and state does the coordinate 38.8977° N, 77.0366° W fall in? I need the GEOIDs so I can join it to Census data.","exampleUseCases":[{"title":"Enriching address data with Census GEOIDs","prompt":"I have a list of lat/lon coordinates from our customer database — for the first one at 34.0522, -118.2437, can you tell me the Census tract GEOID, county, state, and block group so I can join it to ACS demographic data?"},{"title":"Identifying school district for a property","prompt":"We're evaluating a property at latitude 41.8827 and longitude -87.6233 — what school district and county subdivision does it fall in according to Census geography?"},{"title":"Verifying place and ZCTA for a field survey","prompt":"Our field team recorded a GPS reading of lat 29.7604, lon -95.3698 in Houston — can you confirm the Census-defined place, ZCTA, and block GEOID for that coordinate?"}],"resultDescription":"A JSON object containing the matched state name and abbreviation, state FIPS code, county name and GEOID, Census tract GEOID, block GEOID, block group GEOID, place name and GEOID, ZCTA, county subdivision, school district, and the original lat/lon. Also includes a summary, verdict, data source URL, and degraded/not-checked flags if certain layers could not be resolved.","failureModes":["Coordinate outside US territory — no match returned","Invalid or missing lat/lon parameters — validation error","Coordinate in ocean or US waters with no land-based Census geography","Partial results with degraded flag if Census geocoder is unavailable for some layers","Rate limiting or payment failure via x402 protocol"],"whenToPreferThis":"Choose this endpoint when you need authoritative US Census geographic identifiers (GEOIDs) for a coordinate — especially for joining to Census Bureau datasets like ACS, decennial census, or TIGER/Line shapefiles. Prefer it over generic reverse geocoders when you need tract, block, block group, or place GEOIDs rather than just a human-readable address. Best when working with demographic analysis, redistricting, school district lookups, or any workflow requiring Census-compatible geographic identifiers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:11:24.078Z","isFirstParty":false,"canonicalSlug":"us-geography-reverse-geocode-fbe37b65"}