---
title: "Retrieves a zip code list for US cities"
method: GET
path: "/v2/address/state/{state}/city/{city}/zipcode"
tags: ["Address"]
---

# Retrieves a zip code list for US cities

`GET /v2/address/state/{state}/city/{city}/zipcode`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/address/state/{state}/city/{city}/zipcode`
- Auth: API key in header `X-AUTH-TOKEN`
- TypeScript: <https://skmtc.dev/alianza/apis/alianza-public-api/docs/v2/address/state/:state/city/:city/zipcode/get.ts> (a function with typed inputs; its response is checked against the schema)

Use to retrieve a set of ZipCodeX objects for the given city and state in the US.

## Path parameters

- `city` string, required
- `state` string, required

## Response `200`

Successful operation

- ZipcodeX[]
  - `zipCode` string
  - `latitude` number, double
  - `longitude` number, double

## Other responses

- `400`: Invalid request parameters
- `401`: Unauthorized
- `404`: Zipcodes not found

---

[API](https://skmtc.dev/alianza/apis/alianza-public-api.md) - [All operations](https://skmtc.dev/alianza/apis/alianza-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alianza/apis/alianza-public-api/revisions/7223246c352c?raw)