# US Geography: Metro Area Context

> US Geography: Metro Area Context 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-29).

Returns metro or micropolitan area, urban area, county, and urban/rural setting for a US address or lat/lon coordinate.

## Facts

- Endpoint: GET https://geo-us.x402tookit.com/metro-area?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-geography-metro-area-context-4590002d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZmcotFToMk2Pwv11XSw42

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-metro-area-context-4590002d
```

Example prompt: What metro area and urban/rural setting is 742 Evergreen Terrace, Springfield, IL in? I want to know the county, metro or micropolitan area, and whether it's considered urban or rural.

## When to prefer this

Use this endpoint when you need Census-defined metro/micropolitan area classification, urban area codes, or urban/rural setting for a US address or coordinate — especially for eligibility checks, market segmentation, demographic enrichment, or regulatory compliance that relies on official Census statistical area definitions. Prefer this over generic geocoding endpoints when the goal is metropolitan context rather than just lat/lon coordinates.

## Known failure modes

- Address cannot be geocoded or is outside the US — returns null fields or an error
- Lat/lon falls outside US Census-covered territory — returns empty metro/urban fields
- Neither address nor lat/lon provided — request fails validation
- Ambiguous address matched to wrong location — results may be incorrect without verification
- Degraded mode may return partial results if upstream Census data is unavailable

## How this service works

Metro area context for a US address or lat/lon: metro or micropolitan area, urban area, county and urban or rural setting.

## Output

Returns a structured object including: the metro or micropolitan statistical area (name and code), urban area (name and code), combined statistical area (name and code), county name and GEOID, state, urban/rural setting classification, a human-readable summary and verdict, data source and URL, data freshness timestamp, and any degraded-mode flags or disclaimers.

## 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": [],
     "properties": {
      "lat": {
       "type": "number",
       "description": "Latitude (with lon)"
      },
      "lon": {
       "type": "number",
       "description": "Longitude (with lat)"
      },
      "address": {
       "type": "string",
       "description": "US street address (or give lat and lon)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "state": {
       "type": [
        "null",
        "string"
       ]
      },
      "county": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "setting": {
       "type": [
        "null",
        "string"
       ]
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "sourceUrl": {
       "type": [
        "null",
        "string"
       ]
      },
      "urbanArea": {
       "type": [
        "null",
        "object"
       ],
       "properties": {
        "code": {
         "type": [
          "null",
          "string"
         ]
        },
        "name": {
         "type": [
          "null",
          "string"
         ]
        }
       }
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "countyGeoid": {
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-geography-metro-area-context-4590002d/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)