---
title: "Get City by Zipcode"
slug: "get-city-by-zipcode"
updated: 2025-11-10T16:18:39Z
published: 2025-11-10T16:18:39Z
canonical: "documentation.decisions.com/get-city-by-zipcode"
---

> ## 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 City by Zipcode

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 City by Zipcode** step takes in the **tokenid** and **ZIP** **code** to retrieve the associated **city and s****tate**.

### 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 |
| --- | --- | --- |
| TokenID | Allows Users to directly enter a TokenID of the token configured when setting up the module. | String |
| Zip5 | Allows Users to specify a standard five-digit ZIP code. | String |

#### Outputs

| Property | Description | Data Type |
| --- | --- | --- |
| GetCityByZipcode1_Output | The output of this step will use the specified tokenid and ZIP code to retrieve the associated city and state. | String |

---

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

---

## Example Inputs and Outputs

```none
Inputs
TokenId
zip5

Outputs
GetCityByZipcode1_Output
```

#### ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-11-07_15h09_12.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] |