# US State & Territory Lookup

> US State & Territory Lookup 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 name, postal abbreviation, FIPS code, region, division, and capital for any US state or territory identified by name, abbreviation, or FIPS code.

## Facts

- Endpoint: GET https://geo-us.x402tookit.com/us-state-info?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-state-territory-lookup-143f1f62
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P4lxWehwe0Jv7o69jlYvK

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-state-territory-lookup-143f1f62
```

Example prompt: What's the census region, division, and capital for Ohio? I have the state name, but I could also use its FIPS code 39 or abbreviation OH.

## When to prefer this

Use this endpoint when you need to resolve or enrich a US state identifier — whether you have a name, abbreviation, or FIPS code — and need the corresponding census region, division, capital, or normalized identifiers. Prefer this over general geocoding endpoints when working with state-level administrative or census data rather than addresses or coordinates.

## Known failure modes

- Unrecognized state input returns an error or empty result — e.g. misspelled name or invalid FIPS code
- Territories (e.g. Guam, Puerto Rico) may return null for some fields like division if not applicable
- Ambiguous abbreviations could match multiple entries if not a standard postal code
- Network or payment failure returns a 402 or 5xx error with no data

## How this service works

Look up a US state or territory by name, postal abbreviation or FIPS code: all three, region, division and capital.

## Output

Returns a JSON object with the state's full name, postal abbreviation, FIPS code, census region (e.g. South), census division (e.g. East South Central), and capital city. Also includes metadata such as data source and as-of date. May include a degraded flag and reasons if the response is partial.

## 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": [
      "state"
     ],
     "properties": {
      "state": {
       "type": "string",
       "description": "Name, abbreviation or FIPS, e.g. Ohio, OH or 39"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "abbr": {
       "type": [
        "null",
        "string"
       ]
      },
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "fips": {
       "type": [
        "null",
        "string"
       ]
      },
      "name": {
       "type": [
        "null",
        "string"
       ]
      },
      "region": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "capital": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ]
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "division": {
       "type": [
        "null",
        "string"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-state-territory-lookup-143f1f62/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)