---
title: "Get Information By Zip"
slug: "get-information-by-zip"
tags: ["zip", "state", "City"]
updated: 2025-08-21T14:49:18Z
published: 2025-08-21T14:49:18Z
canonical: "documentation.decisions.com/get-information-by-zip"
---

> ## 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.

# Get Information By Zip

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

The **Get Information By Zip** step returns the city, zip code, and state of the specified zip code.

### 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 |
| --- | --- | --- |
| Zip5 | The desired zip code. | String |

#### Outputs

| Property | Description | Data Type |
| --- | --- | --- |
| Output | Information about the zip code. | CityStateLookupResponse |

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-21_10h10_10.png)

---

## Example Inputs and Outputs

| Zip5 | Output |
| --- | --- |
| 23455 | Zip5:"23455", City:"VIRGINIA BEACH", State:"VA", Error:null |
| 23323 | Zip5:"23323", City:"CHESAPEAKE", State:"VA", Error:null |
| Null | Zip5:null, City:null, State:null, Error: Number: "-2147219399", Source:"WebtoolsAMS;CityStateLookup", Description: "Invalid Zip Code." |
| 9023 | Zip5:null, City:null, State:null, Error:[Number:"-2147219024",Source:"WebtoolsAMS;CityStateLookup",Description:"ZIPCode must be 5 characters"] |
| Empty | EXCEPTION MESSAGE |

---

## Common Errors

### Incorrect Parameter Count, Data Not Mapped Correctly

If the zip code is empty, the step will cause an error. To correct this, ensure that a properly formatted zip code is entered or mapped.

#### Exception Message:

```csharp
Exception Stack Trace: DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Get Information By Zip 1[GetInformationByZip] in flow [Flow 1]: Incorrect Parmater Count, Data Not Mapped Correctly
 ---> DecisionsFramework.LoggedException: Incorrect Parmater Count, Data Not Mapped Correctly
 ---> System.Reflection.TargetParameterCountException: Parameter count mismatch. at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture
 at DecisionsFramework.Design.Flow.StepImplementations.InvokeMethodStep.Run(StepStartData data)
   --- 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 Module Example: Get City & State By Zip](https://support.decisions.com/forum/topic29233-usps-module-example-get-city--state-by-zip.aspx) [USPS Address Verification Service](https://support.decisions.com/forum/topic1802-usps-address-verification-service.aspx) [Get State From Zip](https://support.decisions.com/forum/topic3107-usps-integration-get-state-from-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)