Quick Start

One request, one JSON response. No API key required for the free tier.

Request

GET https://zipcheckup.com/api/v1/zip/90210

        Response - JSON
        
      

        {
  "zip":          "90210",
  "score":        72,
  "grade":        "B",
  "violations":   3,
  "lead_level":   "low",
  "radon_zone":   2,
  "flood_claims": 148,
  "components":   {
    "water_quality": 78,
    "lead_risk":     85,
    "radon_risk":    62,
    "flood_risk":    55,
    "air_quality":   71
  },
  "home_value":    {
    "median":           1250000,
    "remediation_cost": 4200,
    "equity_trap_ratio":0.34,
    "purchase_risk_pct":2.1
  }
}
      

Rate limit: 100 requests/day on the free tier. No authentication required. See full API docs for all parameters and response fields.

API Endpoints

RESTful JSON API. All endpoints accept GET requests and return JSON.

Method	Endpoint	Description
GET	`/api/v1/zip/{code}`	Full ZIP code report - score, grade, violations, component breakdown
GET	`/api/v1/state/{code}`	State-level summary - averages, worst ZIPs, violation counts
GET	`/api/v1/rankings/{metric}`	National or state rankings by metric (score, lead, radon, flood)
GET	`/badge/{zip}.svg`	Embeddable SVG score badge for any ZIP code

For detailed parameter documentation, response schemas, and error codes, see the full API reference.

Use Cases

Developers, journalists, and researchers use ZipCheckup data across industries.

Real Estate Platforms

Show home safety scores on property listings. Help buyers compare neighborhoods by water quality, flood risk, environmental factors, median home values, estimated remediation costs, and equity trap ratios.

Insurance Underwriting

Enrich risk models with ZIP-level flood claims, radon zones, and water infrastructure age for more accurate premium pricing.

Home Inspection

Generate pre-inspection reports with local environmental context. Flag high-risk areas for lead, radon, or water quality issues.

Journalism

Investigate local water quality stories with data. Download datasets, compare ZIP codes, and cite government-sourced statistics.

Academic Research

Access structured environmental health data for studies on water contamination, environmental justice, and public health disparities.

Smart Home Apps

Integrate local water quality data into smart home dashboards. Recommend water filters based on actual contaminant levels in the user's ZIP code.

Blockchain & Smart Contracts

Access water quality data on-chain via our API3 Airnode oracle. Build dApps that use real environmental data - no centralized intermediary.

On-Chain Data via Airnode Oracle

ZipCheckup data is available on-chain through API3's Airnode - a first-party oracle that lets smart contracts request water quality scores directly from our API, with no third-party intermediary.

Airnode Endpoint	REST Equivalent	On-Chain Return
`getZipData`	`GET /v1/zip/{zip}`	`data.score` (int256)
`getZipScore`	`GET /v1/zip/{zip}/score`	`data.score` (int256)
`getStateData`	`GET /v1/state/{state}`	`data.avgScore` (int256)
`getRankings`	`GET /v1/rankings`	`data.totalZips` (int256)
`getContaminantData`	`GET /v1/contaminant/{code}`	`data.code` (bytes32)

How It Works

Your smart contract sends a request via the RRP (Request-Response Protocol). Our Airnode, running on a dedicated server, picks up the request, calls the ZipCheckup API, and fulfills the response on-chain. You pay only gas - no oracle fees, no middlemen.

Current Status

Airnode is deployed on Ethereum Sepolia testnet and available for integration testing. Mainnet deployment (Ethereum + Polygon) will follow when there is production demand. Contact us for early access.

Interested in building a dApp with ZipCheckup data? Get in touch - we'll help you integrate.

Embed Widget

Add a ZipCheckup score card to any website with a single line of HTML. No JavaScript required.

HTML

<iframe
  src="https://zipcheckup.com/embed/90210"
  width="400"
  height="300"
  frameborder="0"
  title="ZipCheckup Home Safety Score"
></iframe>

Replace 90210 with any U.S. ZIP code. The widget is responsive and adapts to its container. For more options, try the embed generator.

Badges & Attribution

Add a ZipCheckup badge to your site. Free, auto-updating, shows live data.

Live Preview

Full Badge (with score)

Shows the live Home Safety Score for any ZIP code. Replace 90210 with the target ZIP.

HTML

<a href="https://zipcheckup.com/report/90210/" target="_blank" rel="noopener">
  <img src="https://zipcheckup.com/badge/90210.svg"
       alt="Home Safety Score for ZIP 90210" height="32">
</a>

Compact Badge (text only)

A lightweight text link, ideal for footers or sidebars.

HTML

<a href="https://zipcheckup.com"
   style="font-size:12px;color:var(--gray-text600);text-decoration:none;">
  Powered by ZipCheckup
</a>

Markdown

For README files, GitHub repos, and documentation. Replace 90210 with the target ZIP.

Markdown

[![Home Safety Score](https://zipcheckup.com/badge/90210.svg)](https://zipcheckup.com/report/90210/)

Using our API? A "Built with ZipCheckup" link is appreciated but not required under CC BY 4.0.

Data & Licensing

Open data, transparent methodology, government sources.

CC BY 4.0 License

All ZipCheckup data is available under the Creative Commons Attribution 4.0 license. Use it in commercial and non-commercial projects with attribution.

61+ Government Sources

Data is compiled from EPA SDWIS, FEMA NFIP, CDC PLACES, Census ACS B25077 (home values), DOE, USGS, CPSC, and 40+ other federal and state agencies.

Methodology

Our scoring methodology is fully documented. See the Data & Methodology page for how we calculate composite scores and grade individual risk factors.

Update Frequency

Data is refreshed quarterly from government databases. Violation records and flood claims are updated as new federal data becomes available.

Citation Template

ZipCheckup. "Home Safety Report for [ZIP Code]." ZipCheckup.com, 2026. https://zipcheckup.com/zip/[ZIP]. Accessed [Date]. Licensed under CC BY 4.0.

Rate Limits & Pricing

Start building for free. Scale when you need to.

Free

Starter

$0

forever

100 requests per day
All endpoints included
JSON responses
No API key required
CC BY 4.0 data license

Start Building

Pro

TBD

coming soon

10,000 requests per day
Bulk ZIP lookups
Priority support
Webhook notifications
CSV/GeoJSON exports

Join Waitlist

Enterprise

Custom

contact us

Unlimited requests
Dedicated infrastructure
Custom data feeds
SLA guarantee
White-label options

Contact Us

Tutorials & Guides

Step-by-step walkthroughs to help you get the most out of ZipCheckup data.

ZipCheckup Developer Hub

Quick Start

API Endpoints

Use Cases

Real Estate Platforms

Insurance Underwriting

Home Inspection

Journalism

Academic Research

Smart Home Apps

Blockchain & Smart Contracts

On-Chain Data via Airnode Oracle

How It Works

Current Status

Embed Widget

Badges & Attribution

Full Badge (with score)

Compact Badge (text only)

Markdown

Data & Licensing

CC BY 4.0 License

61+ Government Sources

Methodology

Update Frequency

Citation Template

Rate Limits & Pricing

Starter

Pro

Enterprise

Tutorials & Guides

Add ZipCheckup to Your Zapier/Make Workflow

Embed a Water Quality Widget in Your News Site

Python: Analyze Water Quality Trends

Need More? Let's Talk.