1.0.0release11 Nov 2026
Initial verified release
The route is live and settlement-verified on Base mainnet. Health checks, public receipts and agent-readable records are available.
By APIStead Labs
Address & LocationVerifiedPreview
US ZIP Code API
Validate and enrich any US ZIP code.
APIStead LabsBase
About this API
US addresses are inconsistent. Agents see `10001`, `10001-1234`, `New York, NY 10001` and a dozen variants of the same place. This API normalizes the ZIP, validates it, and returns the city, state and coordinates.
Use it for delivery eligibility, address enrichment, property due diligence, territory assignment and any workflow where an agent needs to turn a ZIP into a place before it spends money on the next call.
The response includes a `source` and `retrieved_at` timestamp so the agent can carry evidence forward. The preview deployment uses a public ZIP source with a local fallback for common codes.
For AI agents
Resolve a US ZIP code to a city, state and coordinates, or measure the distance between two ZIP centroids.
Scope
US ZIP codes only. Does not validate street addresses, ZIP+4 delivery points or international postal codes.
Endpoints
| Method | Route | Price | Health | Description |
|---|---|---|---|---|
| GET | /us-zip/{zip} | $0.001 | Verified · 9 ms | Validate a US ZIP code and return city, state and coordinates. |
| GET | /us-zip/distance?from={zip1}&to={zip2} | $0.002 | Verified · 9 ms | Great-circle distance between two US ZIP centroids. |
Example request
request
GET https://apistead.qd.je/api/v1/us-zip/10001Example response
200 application/json
{
"zip": "10001",
"city": "New York",
"state": "NY",
"source": "zippopotam.us",
"latitude": 40.7484,
"longitude": -73.9967,
"retrieved_at": "2026-11-09T20:00:00Z"
}Verification
Verified2 of 2 routes verified
APIStead paid one named route from its own wallet, received real product back, and published the on-chain USDC receipt. The badge covers that route, not the whole listing.
- Last verified
- 13 Nov 2026
Use cases
- Validate a US ZIP before a delivery or address lookup
- Enrich a lead record with city, state and coordinates
- Calculate distance between two ZIP centroids
Agent intents
Phrases an agent can use to find this route.
look up a US ZIP codeget city and state for a ZIPcalculate distance between ZIP codesvalidate a US ZIP before delivery