Build with the CDXZipStream API

curl -s "https://api.cdxzipstream.com/v1/zip/80401" \
  -H "X-API-Key: cdx_live_YOUR_KEY"

import requests

BASE = "https://api.cdxzipstream.com"
HEADERS = {"X-API-Key": "cdx_live_YOUR_KEY"}

# Single lookup
r = requests.get(f"{BASE}/v1/zip/80401", headers=HEADERS)
r.raise_for_status()
print(r.json())

# The X-Credits-* headers ride on the verify endpoints only.
# Anywhere else, read the balance from /v1/account, which is free to call.
print(requests.get(f"{BASE}/v1/account", headers=HEADERS).json())

# Distance between pairs
r = requests.post(
    f"{BASE}/v1/distance",
    headers=HEADERS,
    json={"pairs": [["80401", "10001"], ["90210", "60601"]], "unit": "miles"},
)
print(r.json())

const BASE = "https://api.cdxzipstream.com";
const headers = {
  "X-API-Key": "cdx_live_YOUR_KEY",
  "Content-Type": "application/json",
};

// Geocode a list of addresses
const res = await fetch(`${BASE}/v1/geocode`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    addresses: ["1600 Pennsylvania Ave NW, Washington, DC 20500"],
  }),
});

if (res.status === 402) throw new Error("Out of credits - top up your account");
if (!res.ok) throw new Error(`CDXZipStream ${res.status}`);

console.log(await res.json());
// Geocode returns no credit headers - read the balance from GET /v1/account

{
  "operations": [
    { "op": "zip",         "args": ["80401"] },
    { "op": "demographics", "args": ["10001"] },
    { "op": "distance",    "args": ["80401", "10001"] }
  ]
}