# US Political Districts Lookup

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

Returns the congressional district and state legislative (upper/lower) districts covering a given US street address, including district codes and state identifiers.

## Facts

- Endpoint: GET https://geo-us.x402tookit.com/political-districts?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-political-districts-lookup-8826af56
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7lNVI8tdcVCykLtDIA1k-

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-political-districts-lookup-8826af56
```

Example prompt: What congressional district and state legislative districts cover 1600 Pennsylvania Ave NW, Washington, DC 20500?

## When to prefer this

Use this endpoint when you need to identify the specific political districts (congressional, state senate, state house) associated with a US street address. Prefer it over generic geocoding endpoints when the goal is civic or political context rather than coordinates, and over census geography endpoints when district codes rather than census tracts are needed.

## Known failure modes

- Address not found or unresolvable — returns null districts with reasons array explaining the failure
- Non-US address provided — likely returns error or null results
- Ambiguous address matched to multiple locations — may return degraded flag with best-guess match
- Missing required address query parameter — request rejected
- Address in US territory without full congressional representation (e.g. DC) — may return partial or null congressional district

## How this service works

Congressional and state legislative (upper and lower) districts covering a US address, with district codes and the state.

## Output

Returns the matched address, state, congressional district (name, code, GEOID), state senate district (name, GEOID), and state house district (name, GEOID), along with a source, asOf date, and any degraded/disclaimer flags indicating data quality.

## 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": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "US street address with city and state or ZIP"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "state": {
       "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"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "matchedAddress": {
       "type": [
        "null",
        "string"
       ]
      },
      "stateHouseDistrict": {},
      "stateSenateDistrict": {
       "type": [
        "null",
        "object"
       ],
       "properties": {
        "name": {
         "type": [
          "null",
          "string"
         ]
        },
        "geoid": {
         "type": [
          "null",
          "string"
         ]
        }
       }
      },
      "congressionalDistrict": {
       "type": [
        "null",
        "object"
       ],
       "properties": {
        "code": {},
        "name": {
         "type": [
          "null",
          "string"
         ]

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-political-districts-lookup-8826af56/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)