{
  "x402Version": 2,
  "id": 72489,
  "slug": "saylorinnovations-api-text-address-normalize",
  "resource": "https://saylorinnovations.com/api/text/address-normalize",
  "description": "Standardize a free-text US address to USPS abbreviations and split it into house number, street, suffix, unit, city, state, ZIP and ZIP+4",
  "type": "http",
  "serviceName": "Saylor Innovations Data Desk",
  "mimeType": "application/json",
  "resourceType": "API",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:137",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:42161",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "So11111111111111111111111111111111111111112",
      "amount": "95830",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    }
  ],
  "outputSchema": {
    "type": "object",
    "properties": {
      "input": {
        "type": "string",
        "description": "Address as supplied"
      },
      "normalized": {
        "type": "string",
        "description": "Single-line USPS-style address"
      },
      "line1": {
        "type": "string",
        "description": "Street line with directionals, suffix and unit"
      },
      "components": {
        "type": "object",
        "properties": {
          "predirectional": {
            "description": "Direction before the street name",
            "type": [
              "string",
              "null"
            ]
          },
          "postdirectional": {
            "description": "Direction after the street name"
          },
          "zip": {
            "description": "5-digit ZIP",
            "type": [
              "string",
              "null"
            ]
          },
          "house_number": {
            "type": [
              "string",
              "null"
            ],
            "description": "House number"
          },
          "street_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Street name"
          },
          "street_suffix": {
            "type": [
              "string",
              "null"
            ],
            "description": "Street suffix"
          },
          "unit": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unit of measure"
          },
          "city": {
            "type": [
              "string",
              "null"
            ],
            "description": "City"
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "description": "State or region"
          },
          "zip_plus4": {
            "type": [
              "string",
              "null"
            ],
            "description": "Zip plus4"
          }
        },
        "description": "Component values"
      },
      "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"
      },
      "note": {
        "type": "string",
        "description": "Caveat or context for reading the result"
      },
      "source": {
        "type": "string",
        "description": "Data source the values come from"
      }
    },
    "required": [
      "normalized",
      "components"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "address": "123 North Main Street, Apartment 4B, Springfield, Illinois 62704-1234"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "input": "123 North Main Street, Apartment 4B, Springfield, Illinois 62704-1234",
            "normalized": "123 N MAIN ST APT 4B, SPRINGFIELD IL 62704-1234",
            "line1": "123 N MAIN ST APT 4B",
            "components": {
              "house_number": "123",
              "predirectional": "N",
              "street_name": "MAIN",
              "street_suffix": "ST",
              "postdirectional": null,
              "unit": "APT 4B",
              "city": "SPRINGFIELD",
              "state": "IL",
              "zip": "62704",
              "zip_plus4": "1234"
            },
            "complete": true,
            "warnings": [],
            "note": "Formatting follows USPS Publication 28 abbreviations; this does not verify that the address exists or is deliverable.",
            "source": "USPS Publication 28 address standardisation rules"
          }
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "type": "string",
                "enum": [
                  "GET"
                ]
              },
              "queryParams": {
                "type": "object",
                "properties": {
                  "address": {
                    "type": "string",
                    "description": "US address as free text, 6-200 characters (commas between street, city and state work best)"
                  }
                },
                "required": [
                  "address"
                ]
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "input": {
                    "type": "string",
                    "description": "Address as supplied"
                  },
                  "normalized": {
                    "type": "string",
                    "description": "Single-line USPS-style address"
                  },
                  "line1": {
                    "type": "string",
                    "description": "Street line with directionals, suffix and unit"
                  },
                  "components": {
                    "type": "object",
                    "properties": {
                      "predirectional": {
                        "description": "Direction before the street name",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "postdirectional": {
                        "description": "Direction after the street name"
                      },
                      "zip": {
                        "description": "5-digit ZIP",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "house_number": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "House number"
                      },
                      "street_name": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Street name"
                      },
                      "street_suffix": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Street suffix"
                      },
                      "unit": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Unit of measure"
                      },
                      "city": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "City"
                      },
                      "state": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "State or region"
                      },
                      "zip_plus4": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Zip plus4"
                      }
                    },
                    "description": "Component values"
                  },
                  "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"
                  },
                  "note": {
                    "type": "string",
                    "description": "Caveat or context for reading the result"
                  },
                  "source": {
                    "type": "string",
                    "description": "Data source the values come from"
                  }
                },
                "required": [
                  "normalized",
                  "components"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "standardize a us mailing address",
    "usps abbreviation for street",
    "split an address into street",
    "normalize addresses",
    "extract zip+4 from an address"
  ],
  "sourceHost": "saylorinnovations.com",
  "lastUpdated": "2026-10-26T22:14:01.953Z",
  "quality": {},
  "metadata": {
    "serviceName": "Saylor Innovations Data Desk",
    "method": "GET",
    "mimeType": "application/json",
    "inputSchema": {
      "type": "object",
      "properties": {
        "address": {
          "type": "string",
          "description": "US address as free text, 6-200 characters (commas between street, city and state work best)"
        }
      },
      "required": [
        "address"
      ]
    },
    "exampleResponse": {
      "input": "123 North Main Street, Apartment 4B, Springfield, Illinois 62704-1234",
      "normalized": "123 N MAIN ST APT 4B, SPRINGFIELD IL 62704-1234",
      "line1": "123 N MAIN ST APT 4B",
      "components": {
        "house_number": "123",
        "predirectional": "N",
        "street_name": "MAIN",
        "street_suffix": "ST",
        "postdirectional": null,
        "unit": "APT 4B",
        "city": "SPRINGFIELD",
        "state": "IL",
        "zip": "62704",
        "zip_plus4": "1234"
      },
      "complete": true,
      "warnings": [],
      "note": "Formatting follows USPS Publication 28 abbreviations; this does not verify that the address exists or is deliverable.",
      "source": "USPS Publication 28 address standardisation rules"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "address": "123 North Main Street, Apartment 4B, Springfield, Illinois 62704-1234"
            }
          },
          "output": {
            "type": "json",
            "example": {
              "input": "123 North Main Street, Apartment 4B, Springfield, Illinois 62704-1234",
              "normalized": "123 N MAIN ST APT 4B, SPRINGFIELD IL 62704-1234",
              "line1": "123 N MAIN ST APT 4B",
              "components": {
                "house_number": "123",
                "predirectional": "N",
                "street_name": "MAIN",
                "street_suffix": "ST",
                "postdirectional": null,
                "unit": "APT 4B",
                "city": "SPRINGFIELD",
                "state": "IL",
                "zip": "62704",
                "zip_plus4": "1234"
              },
              "complete": true,
              "warnings": [],
              "note": "Formatting follows USPS Publication 28 abbreviations; this does not verify that the address exists or is deliverable.",
              "source": "USPS Publication 28 address standardisation rules"
            }
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "input": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "http"
                },
                "method": {
                  "type": "string",
                  "enum": [
                    "GET"
                  ]
                },
                "queryParams": {
                  "type": "object",
                  "properties": {
                    "address": {
                      "type": "string",
                      "description": "US address as free text, 6-200 characters (commas between street, city and state work best)"
                    }
                  },
                  "required": [
                    "address"
                  ]
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "input": {
                      "type": "string",
                      "description": "Address as supplied"
                    },
                    "normalized": {
                      "type": "string",
                      "description": "Single-line USPS-style address"
                    },
                    "line1": {
                      "type": "string",
                      "description": "Street line with directionals, suffix and unit"
                    },
                    "components": {
                      "type": "object",
                      "properties": {
                        "predirectional": {
                          "description": "Direction before the street name",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "postdirectional": {
                          "description": "Direction after the street name"
                        },
                        "zip": {
                          "description": "5-digit ZIP",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "house_number": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "House number"
                        },
                        "street_name": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Street name"
                        },
                        "street_suffix": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Street suffix"
                        },
                        "unit": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Unit of measure"
                        },
                        "city": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "City"
                        },
                        "state": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "State or region"
                        },
                        "zip_plus4": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Zip plus4"
                        }
                      },
                      "description": "Component values"
                    },
                    "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"
                    },
                    "note": {
                      "type": "string",
                      "description": "Caveat or context for reading the result"
                    },
                    "source": {
                      "type": "string",
                      "description": "Data source the values come from"
                    }
                  },
                  "required": [
                    "normalized",
                    "components"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/text/address-normalize?address=123%20North%20Main%20Street%2C%20Apartment%204B%2C%20Springfield%2C%20Illinois%2062704-1234",
        "expectedStatus": 402
      }
    ],
    "cacheTtlSeconds": 0,
    "capabilities": [],
    "noAccountRequired": true,
    "noApiKeyRequired": true,
    "sideEffects": "Paid calls settle the advertised payment; see the provider contract for execution behavior.",
    "payment": {
      "protocol": "x402",
      "settlement": "direct-to-provider"
    },
    "provider": {
      "name": "Saylor Innovations",
      "host": "saylorinnovations.com",
      "manifestUrl": "https://saylorinnovations.com/.well-known/x402.json"
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": true,
  "featured": false,
  "provider": {
    "host": "saylorinnovations.com",
    "manifest_name": "Saylor Innovations Knowledge Base",
    "source": "submitted",
    "source_manifest_url": "https://saylorinnovations.com/.well-known/x402.json",
    "submitted_at": "2026-10-26T05:52:02.113Z"
  },
  "exampleResponse": {
    "input": "string",
    "normalized": "string",
    "line1": "string",
    "components": {
      "predirectional": "string",
      "postdirectional": null,
      "zip": "string",
      "house_number": "string",
      "street_name": "string",
      "street_suffix": "string",
      "unit": "string",
      "city": "string",
      "state": "string",
      "zip_plus4": "string"
    },
    "complete": true,
    "warnings": [
      "value"
    ],
    "note": "string",
    "source": "string"
  }
}