Water Quality API

Quick Start

# Get water quality data for ZIP 90210
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.zipcheckup.com/v1/zip/90210"

# Get safety score only
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.zipcheckup.com/v1/zip/90210/score"

# State summary
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.zipcheckup.com/v1/state/CA"

import requests

API_KEY = "YOUR_API_KEY"
BASE    = "https://api.zipcheckup.com/v1"

headers = {"X-API-Key": API_KEY}

# Full water quality data
r = requests.get(f"{BASE}/zip/90210", headers=headers)
data = r.json()

print(f"Score: {data['score']} ({data['grade']})")
print(f"Contaminants: {len(data['contaminants'])}")

# Top 50 worst ZIPs
r = requests.get(f"{BASE}/rankings?limit=50&order=asc", headers=headers)
for z in r.json()["rankings"]:
    print(f"{z['zip']}: {z['score']}")

const API_KEY = "YOUR_API_KEY";
const BASE    = "https://api.zipcheckup.com/v1";

const headers = { "X-API-Key": API_KEY };

// Full water quality data
const res = await fetch(`${BASE}/zip/90210`, { headers });
const data = await res.json();

console.log(`Score: ${data.score} (${data.grade})`);
console.log(`Contaminants: ${data.contaminants.length}`);

// State summary
const state = await (await fetch(`${BASE}/state/CA`, { headers })).json();
console.log(`CA avg score: ${state.avgScore}`);

library(httr2)
library(jsonlite)

api_key <- "YOUR_API_KEY"
base    <- "https://api.zipcheckup.com/v1"

# Full water quality data
resp <- request(paste0(base, "/zip/90210")) |>
  req_headers("X-API-Key" = api_key) |>
  req_perform()

data <- resp |> resp_body_json()
cat(sprintf("Score: %s (%s)\n", data$score, data$grade))

# Rankings as data frame
rankings <- request(paste0(base, "/rankings?limit=50&order=asc")) |>
  req_headers("X-API-Key" = api_key) |>
  req_perform() |>
  resp_body_json()

df <- do.call(rbind, lapply(rankings$rankings, as.data.frame))
head(df)