{"uid":"cap_yLwJlpcKhKiBtfW-H1Fe3","slug":"us-geography-geoid-parser-38ad9624","name":"US Geography GEOID Parser","description":"Parse a Census GEOID into state, county, tract, block group and block codes and name its geographic level.","url":"https://geo-us.x402tookit.com/geoid-parse?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":["geoid"],"properties":{"geoid":{"type":"string","description":"Numeric GEOID of 2, 5, 11, 12 or 15 digits"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"block":{"type":["null","string"]},"level":{"type":["null","string"]},"state":{"type":["null","object"],"properties":{"abbr":{"type":["null","string"]},"fips":{"type":["null","string"]},"name":{"type":["null","string"]}}},"tract":{"type":["null","string"]},"county":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"blockGroup":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"tractLabel":{"type":["null","string"]},"countyGeoid":{"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_5UZR5ulwrKG0Ql6s3l8D-","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":"Parse a numeric Census GEOID (2–15 digits) into its component geographic codes (state, county, tract, block group, block) and identify the geographic level.","exampleAgentPrompt":"Can you parse the Census GEOID 360610191001004 and tell me which state, county, tract, block group, and block it refers to, and what geographic level it is?","exampleUseCases":[{"title":"Enriching Census data pipeline","prompt":"I have a list of Census GEOIDs from a dataset and I need to know the state, county, tract, and block group for GEOID 48201223100 — can you break that down for me?"},{"title":"Validating block-level geography","prompt":"We pulled GEOID 060375354021023 from a survey record — can you parse it out and confirm what geographic level it is and which state and county it falls in?"},{"title":"Identifying state from FIPS prefix","prompt":"I have a 2-digit GEOID, 06 — what state does that correspond to and what geographic level is it?"}],"resultDescription":"Returns the parsed geographic components of the GEOID: state (FIPS code, name, abbreviation), county code, tract code, block group code, block code, and a label for the geographic level (e.g. state, county, tract, block group, or block). Also includes a human-readable summary, data source, and optional degradation or disclaimer flags.","failureModes":["Invalid GEOID length (not 2, 5, 11, 12, or 15 digits) returns an error or empty result","Non-numeric GEOID string causes a validation failure","GEOID that doesn't match any known Census geography returns null or empty fields","Missing required 'geoid' query parameter results in a bad request error","Network or provider unavailability returns a timeout or service error"],"whenToPreferThis":"Use this endpoint when you have a raw numeric Census GEOID string and need to decompose it into its hierarchical geographic components (state, county, tract, block group, block) or identify which level of the Census hierarchy it represents. Prefer this over geocoding endpoints when you already have a GEOID and don't need to reverse-geocode a coordinate or address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:35:01.472Z","isFirstParty":false,"canonicalSlug":"us-geography-geoid-parser-38ad9624"}