---
title: "Get Address"
slug: "get-address"
updated: 2025-11-10T16:13:27Z
published: 2025-11-10T16:13:27Z
canonical: "documentation.decisions.com/get-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.

# Get Address

USPS API ChangeSince USPS is changing its API in January 2026, new steps have been added to the [USPS Module](https://documentation.decisions.com/docs/usps) for v9.17. All steps added to the USPS Module before v9.17 will be marked as deprecated, but will still work in the platform. Users must use the new steps once the change takes place. **N****ew** **steps added to the platform from the 9.17 release are not a direct replacement for deprecated steps; Flow logic may need to be updated to account for this.** 

| Step Details |
| --- |
| **Introduced in Version** | 9.17 |
| **Last Modified in Version** | 9.17 |
| **Location** | Integration > USPS |

### Overview

The **Get Address** step takes in specific address data and utilizes it to retrieve a completed address. For example, a User may have an address with a city and state, but no ZIP code. The step would then use this information to return an address with the correct zipcode. Although a **tokenid** is required, not all properties must be filled out for the step to work.

### 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.
- Users must [add the module as a dependency](https://documentation.decisions.com/docs/project-dependencies#add-a-project-dependency-or-enable-a-module) to a Project before utilizing any associated steps.
- This step requires an **OAuth Token** for verification. Please refer to the following articles for more information:
  - [Establishing an OAuth Provider](https://documentation.decisions.com/docs/establishing-an-oauth-provider)
  - [Creating OAuth Tokens](https://documentation.decisions.com/docs/creating-oauth-tokens)

---

## Properties

#### Inputs

| Property | Description | Data Type |
| --- | --- | --- |
| Address1 | Allows Users to specify the name of a street address. | String |
| Address2 | Allows Users to specify additional data for an address, such as an apartment number. | String |
| City | Allows Users to specify a City's name. | String |
| Firm | Allows Users to specify the name of a Firm/Business. | String |
| State | Allows Users to specify the name of a State. | String |
| TokenID | Allows Users to directly enter a TokenID of the token configured when setting up the module. | String |
| Urbanization | Allows Users to specify a [URB descriptor](https://pe.usps.com/text/pub28/28c2_042.htm). | String |
| Zip4 | Allows Users to specify an additional four digits of a ZIP code. These digits are utilized for more precise mail delivery. | String |
| Zip5 | Allows Users to specify a standard five-digit ZIP code. | String |

#### Outputs

| Property | Description | Data Type |
| --- | --- | --- |
| GetAddress1_Output | The output of this step will use the specified data to retrieve a complete address. Data included in this address will consist of properties in the previous section. | Address |

---

## ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-11-07_14h33_20.png)

---

## Example Inputs and Outputs

```none
Inputs
TokenId
address1
city
state

Outputs
address1
city
state
Zip4
Zip5
Error
```

#### ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-11-07_12h44_20(1).png)

---

## Step Changes

| Description | Version | Date | Developer Task |
| --- | --- | --- | --- |
| The USPS module has been updated with new steps. Old steps have been marked as deprecated in the toolbox. | [9.17](https://portal.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/document/v99/view/9d550007-0b3a-4a79-8253-fecac31ed501) | November 2025 | [DT-045903] |