All postal codes for a city API

Reverse of a ZIP lookup: given a country, state/region, and city name, return ALL postal codes covering that place, with each code's coordinates plus the derived count and centroid. Answers 'what ZIP codes are in this city', 'all postcodes for a town', 'centroid of a city's postal codes'.

Price$0.01per request

MethodPOST

Route/v1/data/places-postal-codes-for-place

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

dataplacespostal-codezipreverse-lookupcityzippopotamlogistics

API URLhttps://x402.hexl.dev/v1/data/places-postal-codes-for-place

Integration docs

Example request

{
  "country": "us",
  "state": "ma",
  "city": "belmont"
}

Example response

{
  "country": "United States",
  "countryCode": "US",
  "state": "Massachusetts",
  "stateCode": "MA",
  "city": "Belmont",
  "postalCodeCount": 2,
  "centroid": {
    "latitude": 42.4296,
    "longitude": -71.3319
  },
  "postalCodes": [
    {
      "postalCode": "02178",
      "placeName": "Belmont",
      "latitude": 42.4464,
      "longitude": -71.4594
    },
    {
      "postalCode": "02478",
      "placeName": "Belmont",
      "latitude": 42.4128,
      "longitude": -71.2044
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "state",
    "city"
  ],
  "properties": {
    "country": {
      "type": "string",
      "default": "us"
    },
    "state": {
      "type": "string"
    },
    "city": {
      "type": "string"
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}