# Dorothy Data US Address Enrichment API

> Dorothy Data US Address Enrichment API is a paid API for AI agents from www.dorothydata.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Enriches a US address with census tracts, coordinates, congressional districts, school districts, timezone, and other geopolitical metadata.

## Facts

- Endpoint: POST https://www.dorothydata.com/api/v1/enrich/paid?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dorothy-data-us-address-enrichment-api-827bc20d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__I0_gelvI1xXgWR1JZ90q

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 dorothy-data-us-address-enrichment-api-827bc20d -d '<json body>'
```

Example prompt: Can you enrich this address with census tract, congressional district, school district, and timezone info: 1600 Pennsylvania Ave NW, Washington DC 20500?

## When to prefer this

Use this endpoint when you need structured US government geographic identifiers (census tract, FIPS codes, congressional district, school district) for a single US address. Prefer this over generic geocoding APIs when civic, demographic, or policy-related metadata is required alongside coordinates.

## Known failure modes

- Invalid or unrecognizable address returns an error or empty data object
- Non-US addresses are not supported and will fail
- Ambiguous addresses (e.g. missing city or state) may return incorrect or no results
- Payment failure via x402 protocol results in a 402 response and no data
- Rate limiting or service outage returns 5xx errors

## How this service works

US address metadata for agents and apps. Census tracts, congressional districts, school districts, and more.

## Output

Returns a JSON object with the standardized address, state, county, zip code, timezone, lat/lng coordinates, state and county FIPS codes, census tract, census block, census block group, urban/rural classification, school district name, congressional district code and name, and the data sources used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "A US street address to geocode and enrich."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "input": "1600 Pennsylvania Ave NW, Washington DC 20500",
   "state": "District of Columbia",
   "county": "District of Columbia",
   "sources": [
    "US Census Geocoder",
    "US Census TIGERweb"
   ],
   "zipCode": "20500",
   "timezone": "America/New_York",
   "stateFips": "11",
   "countyFips": "11001",
   "urbanRural": "Washington--Arlington, DC--VA--MD Urban Area",
   "censusBlock": "110019800001034",
   "censusTract": "980000",
   "coordinates": {
    "lat": 38.89869893252,
    "lng": -77.03518753691
   },
   "schoolDistrict": "District of Columbia Public Schools",
   "censusBlockGroup": "110019800001",
   "censusTractGeoid": "11001980000",
   "stateAbbreviation": "DC",
   "standardizedAddress": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500",
   "congressionalDistrict": "DC-AL",
   "congressionalDistrictName": "Delegate District (at Large)"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dorothy-data-us-address-enrichment-api-827bc20d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.dorothydata.com](https://www.zero.xyz/host/www.dorothydata.com/llms.txt)