# US Geography GEOID Parser

> US Geography GEOID Parser is a paid API for AI agents from geo-us.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Parse a numeric Census GEOID (2–15 digits) into its component geographic codes (state, county, tract, block group, block) and identify the geographic level.

## Facts

- Endpoint: GET https://geo-us.x402tookit.com/geoid-parse?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-geography-geoid-parser-38ad9624
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yLwJlpcKhKiBtfW-H1Fe3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability us-geography-geoid-parser-38ad9624
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Parse a Census GEOID into state, county, tract, block group and block codes and name its geographic level.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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",
        "stri
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-geography-geoid-parser-38ad9624/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from geo-us.x402tookit.com](https://www.zero.xyz/host/geo-us.x402tookit.com/llms.txt)