# Eckari US Census Geography Lookup

> Eckari US Census Geography Lookup is a paid API for AI agents from api.eckari.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-13).

Returns all official US Census Bureau geographies (state, county, tract, block, place, congressional district, ZCTA) containing a given latitude/longitude, each with its FIPS or GEOID.

## Facts

- Endpoint: GET https://api.eckari.com/v1/locations/us/geographies?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eckari-us-census-geography-lookup-8c685733
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_M96Syo5_etYon3L225BfP

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 eckari-us-census-geography-lookup-8c685733
```

Example prompt: What US Census geographies contain the White House at latitude 38.8977, longitude -77.0365? I need the state, county, census tract, block, congressional district, and ZCTA GEOIDs.

## When to prefer this

Use this endpoint when you need official US Census Bureau FIPS codes or GEOIDs for a geographic point — e.g. to join with ACS demographic data, comply with government reporting requirements, assign congressional districts, or enrich business location data with statistical geography. Prefer this over generic reverse geocoding services (Google Maps, Mapbox) when you specifically need Census identifiers (FIPS, GEOID) rather than street addresses or postal codes. It covers all major Census geographies in a single call.

## Known failure modes

- Coordinate outside the US returns no geography matches
- Invalid latitude or longitude values (out of -90/90 or -180/180 range) trigger a 400 error
- Coordinates in US territories or waters may have partial or no results
- Network timeout if Census Geocoder upstream is slow
- Missing required lat or lon query parameters result in validation error

## How this service works

Return the US Census Bureau geographies containing a latitude/longitude — state, county, census tract, block group, census block, incorporated place, congressional district and ZIP Code Tabulation Area — each with its FIPS or GEOID. The standard way to attach official US statistical geography to a point. Use when: Which county and census tract is this coordinate in?

## Output

A JSON object containing the full set of US Census geographies for the queried point: state (FIPS + name + USPS abbreviation), county (FIPS + name), census tract (GEOID + name), census block (GEOID), block group (GEOID), incorporated place (GEOID + name), congressional district (GEOID + name), and ZCTA (GEOID), plus the original query coordinates, Census benchmark/vintage used, and metadata about the data source and version.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "maximum": 90,
       "minimum": -90,
       "description": "Latitude in decimal degrees (WGS 84), e.g. 38.8977."
      },
      "lon": {
       "type": "number",
       "maximum": 180,
       "minimum": -180,
       "description": "Longitude in decimal degrees (WGS 84), negative in the western hemisphere, e.g. -77.0365."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "zcta": {
    "geoid": "20006"
   },
   "block": {
    "geoid": "110019800001034"
   },
   "place": {
    "name": "Washington city",
    "geoid": "1150000"
   },
   "query": {
    "lat": 38.8977,
    "lon": -77.0365
   },
   "state": {
    "fips": "11",
    "name": "District of Columbia",
    "usps": "DC"
   },
   "tract": {
    "name": "Census Tract 9800",
    "geoid": "11001980000"
   },
   "county": {
    "fips": "11001",
    "name": "District of Columbia"
   },
   "vintage": "Current_Current",
   "benchmark": "Public_AR_Current",
   "block_group": {
    "geoid": "110019800001"
   },
   "congressional_district": {
    "name": "Delegate District (at Large)",
    "geoid": "1198"
   }
  },
  "meta": {
   "source": "census_geocoder",
   "version": "2.0.0",
   "freshness": "live",
   "capability": "location.us.geographies"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eckari-us-census-geography-lookup-8c685733/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.eckari.com](https://www.zero.xyz/host/api.eckari.com/llms.txt)