---
title: "Normalize Address"
slug: "normalize-address"
tags: ["address", "state", "City", "zip"]
updated: 2025-08-21T14:50:40Z
published: 2025-08-21T14:50:40Z
canonical: "documentation.decisions.com/normalize-address"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Normalize Address

| ## Step Details |
| --- |
| **Introduced in Version** | 4.0.0 |
| **Last Modified in Version** | 7.1.0 |
| **Location** | Integration > USPS |

The **Normalize Address** step returns the full address information, including the full zip code for the address (the 5-digit zip code and the additional 4 digits after the zip code, i.e., 23644-1243).

### Prerequisites

This step requires the USPS module to be [installed](https://documentation.decisions.com/docs/installing-modules-decisions) before it will be available in the toolbox.

---

## Properties

#### Inputs

| Property | Description | Data Type |
| --- | --- | --- |
| Address1 | The desired address information. | String |
| Address2 | The desired address information. | String |
| City | The city of the address. | String |
| State | The 2 character abbreviation of the state. (i.e., VA for Virginia) | String |

#### Outputs

| Property | Description | Data Type |
| --- | --- | --- |
| Output | Outputs the specified address with zip code. | Address |

---

## Example Inputs and Outputs

| Address1 | Address2 | City | State | Output |
| --- | --- | --- | --- | --- |
| 722 Indian River Road | Null | Virginia Beach | VA | EXCEPTION MESSAGE |
| 6633 E Virginia Beach Blvd | Null | Norfolk | VA | Address2:"6633 E Virginia Beach BLVD", City:"NORFOLK",State:"VA",Zip4:"3013",Zip5:"23502",Error:null |
| 1466 S Idalia St | Empty | Aurura | CO | Address2:"1466 S IDALIA ST", City:"AURORA",State:"CO",Zip4:"",Zip5:"80017",Error:null |
| Null | Ignore | El Paso | TX | EXCEPTION MESSAGE |
| Empty | Null | Denver | CO | EXCEPTION MESSAGE |

---

## Common Errors

### Address Not Found.

If Address1 has a value that is invalid, null, or empty, the step will cause an error. To correct this, ensure that the value entered or mapped for Address1 is correctly formatted.

#### Exception Message:

```csharp
Exception Stack Trace: DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Normalize Address 1[NormalizeAddress] in flow [Flow 1]: Exception invoking method NormalizeAddress on class USPSSteps
 ---> DecisionsFramework.LoggedException: Exception invoking method NormalizeAddress on class USPSSteps
 ---> Decisions.USPS.USPSException: Address Not Found.
 at Decisions.USPS.USPSSteps.NormalizeAddress(String address1, String address2, String city, String state)
   --- End of inner exception stack trace --- at DecisionsFramework.Design.Flow.StepImplementations.InvokeMethodStep.Run(StepStartData data
 at DecisionsFramework.Design.Flow.FlowStep.RunStepInternal(String flowTrackingID, String stepTrackingID, KeyValuePairDataStructure[] stepRunDataValues, AbstractFlowTrackingData trackingData
 at DecisionsFramework.Design.Flow.FlowStep.Start(String flowTrackingID, String stepTrackingID, FlowStateData data, AbstractFlowTrackingData trackingData, RunningStepData currentStepData)
   --- End of inner exception stack trace ---
```

---

Related Information

Forum Posts: [USPS Integration: Get State From Zip](https://support.decisions.com/forum/topic3107-usps-integration-get-state-from-zip.aspx) [USPS Module Example: Get City & State By Zip](https://support.decisions.com/forum/topic29233-usps-module-example-get-city--state-by-zip.aspx)

## Related

- [Get Cities By Zips](/get-cities-by-zips.md)
- [Get City By Zip](/get-city-by-zip.md)
- [Get Zip By City](/get-zip-by-city.md)
- [Is Zip Valid For City](/is-zip-valid-for-city.md)
- [Get Information By Zip](/get-information-by-zip.md)