---
title: "POST /v1/addver/zip_codes"
method: POST
path: "/v1/addver/zip_codes"
tags: ["Standard API"]
---

# POST /v1/addver/zip_codes

`POST /v1/addver/zip_codes`

Looks up all ZIP codes that correspond to a given US city and state.

- Currently only supported for US addresses (`countryCode: "US"`).
- Uses 1 lookup.

## Request body

- object
  - `city` string, required — The city name.
  - `state` string, required — The state abbreviation (e.g. `NY`).
  - `countryCode` string, required — The country code. Currently only `US` is supported.

## Response `200`

The request has succeeded.

- object
  - `status` 'success' | 'error', required
  - `message` string, required
  - `data` object, required
    - `zipCodes` string[], required

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `403` — Access is forbidden.

---

[API](https://skmtc.net/postgrid/apis/postgrid-address-verification-api.md) · [All operations](https://skmtc.net/postgrid/apis/postgrid-address-verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/postgrid/postgrid-address-verification-api/versions/537d2bbc624a/schema)