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

# POST /v1/addver/city_states

`POST /v1/addver/city_states`

Looks up city, county, and other location metadata for a given US or
Canadian postal code or ZIP code.

A single postal code may map to multiple cities (e.g. a ZIP that spans
several towns), so the response is an array.

- Uses 1 lookup.

## Request body

- object
  - `postalOrZip` string, required

## Response `200`

The request has succeeded.

- object
  - `status` 'success' | 'error', required
  - `message` string, required
  - `data` CityState[], required
    - `city` string, required — The city name.
    - `country` string, required — The ISO 2-letter country code.
    - `county` string — The county name (US addresses only).
    - `countyFIPS` string — The FIPS code for the county (US addresses only).
    - `mailable` boolean — Whether the location is mailable.
    - `preferredCity` string — The USPS preferred city name for this postal code.
    - `provinceOrState` string, required — The province or state abbreviation.
    - `zipClass` string — The USPS ZIP code class (e.g. `S` for standard, `P` for PO Box only).

## 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/revisions/537d2bbc624a/schema)