v7

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-121372601.5 MB
Standard API

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.
post/v1/addver/city_states

Request body

postalOrZipstring required

Response

The request has succeeded.

status'success' | 'error' required
messagestring required