Data

Postal / ZIP code lookup API

Resolve a postal/ZIP code to its place name(s), state/region, and coordinates, for a country (Zippopotam). Answers 'city for ZIP 90210', 'where is postcode X', 'coordinates of this ZIP', 'what state is this ZIP in'. Forms & logistics.

Price$0.01per request

MethodPOST

Route/v1/data/zip

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache86400s public

datazippostal-codelocationgeocodeaddresscitylogistics

API URLhttps://x402.hexl.dev/v1/data/zip

Integration docs

Example request

{
  "code": "90210"
}

Example response

{
  "code": "90210",
  "country": "United States",
  "countryCode": "US",
  "places": [
    {
      "name": "Beverly Hills",
      "state": "California",
      "stateCode": "CA",
      "latitude": 34.0901,
      "longitude": -118.4065
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "examples": [
        "90210"
      ]
    },
    "country": {
      "type": "string",
      "default": "us",
      "examples": [
        "us"
      ]
    }
  }
}

Output schema

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