United States Postal Service · Schema

CityState

City and state lookup result.

GovernmentPostal ServiceShippingLogisticsAddress ValidationPackage Tracking

Properties

Name Type Description
city string City name.
state string Two-letter state abbreviation.
ZIPCode string The queried ZIP Code.
View JSON Schema on GitHub

JSON Schema

addresses-city-state-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/united-states-postal-service/refs/heads/main/json-schema/addresses-city-state-schema.json",
  "title": "CityState",
  "description": "City and state lookup result.",
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name.",
      "example": "WASHINGTON"
    },
    "state": {
      "type": "string",
      "description": "Two-letter state abbreviation.",
      "example": "DC"
    },
    "ZIPCode": {
      "type": "string",
      "description": "The queried ZIP Code.",
      "example": "20212"
    }
  }
}