# Saylor Innovations Data Desk – US Address Normalizer

> Saylor Innovations Data Desk – US Address Normalizer is a paid API for AI agents from saylorinnovations.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Parses and standardizes a free-text US address into USPS-compliant components including house number, street, suffix, unit, city, state, ZIP, and ZIP+4

## Facts

- Endpoint: GET https://saylorinnovations.com/api/text/address-normalize?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/saylor-innovations-data-desk-us-address-normalizer-840d1073
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eG411Eu5C3FyhPQLLNRRZ

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 saylor-innovations-data-desk-us-address-normalizer-840d1073
```

Example prompt: Can you normalize this address to USPS format and break it into its components — house number, street, city, state, and ZIP? The address is: 1600 Pennsylvania Avenue NW, Washington DC 20500

## When to prefer this

Choose this endpoint when you need to standardize US postal addresses to USPS format and extract structured components from free-text input. It is purpose-built for US addresses and returns granular field-level decomposition including ZIP+4, making it ideal for data cleaning pipelines, form validation, mail presort, or database normalization. Prefer this over generic geocoding APIs when you need structured postal components rather than coordinates.

## Known failure modes

- Address too short or too long (outside 6-200 character range) returns validation error
- Non-US addresses cannot be parsed and will return incomplete results or errors
- Highly ambiguous or malformed addresses may return incomplete=false with warnings
- Missing ZIP code in input may result in null zip and zip_plus4 fields
- Street suffix not recognized may appear in warnings array

## How this service works

Standardize a free-text US address to USPS abbreviations and split it into house number, street, suffix, unit, city, state, ZIP and ZIP+4

## Output

Returns a JSON object containing: a single-line normalized address string, structured components (house_number, street_name, street_suffix, predirectional, postdirectional, unit, city, state, zip, zip_plus4), a boolean 'complete' flag indicating whether all key parts were found, any warnings about unrecognized parts, the original input string, and the data source used.

## 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 address as free text, 6-200 characters (commas between street, city and state work best)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "required": [
      "normalized",
      "components"
     ],
     "properties": {
      "note": {
       "type": "string",
       "description": "Caveat or context for reading the result"
      },
      "input": {
       "type": "string",
       "description": "Address as supplied"
      },
      "line1": {
       "type": "string",
       "description": "Street line with directionals, suffix and unit"
      },
      "source": {
       "type": "string",
       "description": "Data source the values come from"
      },
      "complete": {
       "type": "boolean",
       "description": "True when house number, street, city, state and ZIP were all found"
      },
      "warnings": {
       "type": "array",
       "description": "Parts that could not be identified"
      },
      "components": {
       "type": "object",
       "properties": {
        "zip": {
         "type": [
          "string",
          "null"
         ],
         "description": "5-digit ZIP"
        },
        "city": {
         "type": [
          "string",
          "null"
         ],
         "description": "City"
        },
        "unit": {
         "type": [
          "string",
          "null"
         ],
         "description": "Unit of measure"
        },
        "state": {
         "type": [
          "string",
          "null"
         ],
         "description": "State or region"
        },
        "zip_plus4": {
         "type": [
          "string",
          "null"
         ],
         "description": "Zip plus4"
        },
        "street_name": {
         "type": [
          "string",
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/saylor-innovations-data-desk-us-address-normalizer-840d1073/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from saylorinnovations.com](https://www.zero.xyz/host/saylorinnovations.com/llms.txt)