{
  "id": "us-zip-code-api",
  "slug": "us-zip-code-api",
  "name": "US ZIP Code API",
  "provider": {
    "slug": "apistead-labs",
    "name": "APIStead Labs",
    "verified": true
  },
  "category": "Address & Location",
  "tagline": "Validate and enrich any US ZIP code.",
  "description": "US ZIP code lookup with city, state, coordinates and distance between ZIP centroids. Stable JSON for address, delivery and property workflows.",
  "agent_summary": "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.",
  "intent_phrases": [
    "look up a US ZIP code",
    "get city and state for a ZIP",
    "calculate distance between ZIP codes",
    "validate a US ZIP before delivery"
  ],
  "faqs": [],
  "code_examples": [],
  "price": {
    "min_usdc": 0.001,
    "max_usdc": 0.002,
    "unit": "per_call"
  },
  "payment": {
    "protocol": "x402",
    "protocol_version": 2,
    "network": "eip155:8453",
    "network_name": "Base",
    "asset": "USDC",
    "price_min_usdc": 0.001,
    "price_max_usdc": 0.002,
    "unit": "per_call",
    "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235",
    "authoritative_source": "402_challenge"
  },
  "networks": [
    "base"
  ],
  "primary_network": "base",
  "verification": "verified",
  "verification_detail": {
    "state": "verified",
    "verified_routes": 2,
    "total_routes": 2,
    "last_verified_at": "2026-11-13T13:52:19.855Z",
    "receipt_url": "https://basescan.org/tx/0x73b29cce8aa1258c1fbb2e89281e070df0456f00245e5f17cb9c2be161b3c69e"
  },
  "verified_routes": 2,
  "total_routes": 2,
  "reliability": {
    "score": 87,
    "band": "caution",
    "uptime30d": 87,
    "lastCheckedAt": "2026-11-14T04:35:10.714Z"
  },
  "last_verified_at": "2026-11-13T13:52:19.855Z",
  "receipt_url": "https://basescan.org/tx/0x73b29cce8aa1258c1fbb2e89281e070df0456f00245e5f17cb9c2be161b3c69e",
  "base_url": "https://apistead.qd.je/api/v1",
  "mcp_endpoint": "https://apistead.qd.je/mcp",
  "docs_url": "https://apistead.qd.je/api",
  "tags": [
    "us",
    "zip",
    "postal-code",
    "address",
    "geocoding",
    "delivery"
  ],
  "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"
  ],
  "links": {
    "docs": "https://apistead.qd.je/api",
    "json": "https://x402.apistead.qd.je/api/apis/us-zip-code-api",
    "markdown": "https://x402.apistead.qd.je/api/apis/us-zip-code-api/md",
    "routes": "https://x402.apistead.qd.je/agent/routes?id=us-zip-code-api",
    "receipts": "https://x402.apistead.qd.je/agent/receipts?id=us-zip-code-api",
    "api_reference": "https://x402.apistead.qd.je/api",
    "mcp_guide": "https://x402.apistead.qd.je/mcp-docs",
    "skill": "https://x402.apistead.qd.je/skill",
    "openapi": "https://x402.apistead.qd.je/openapi.json"
  },
  "demo": true,
  "long_description": "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.\n\nUse 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.\n\nThe 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.",
  "provider_detail": {
    "slug": "apistead-labs",
    "name": "APIStead Labs",
    "description": "First-party data APIs built and verified by APIStead. US ZIP codes, IP intelligence, geocoding, weather, email and public records, all priced per call.",
    "website": "https://apistead.qd.je",
    "verified": true,
    "firstParty": true
  },
  "routes": [
    {
      "method": "GET",
      "path": "/us-zip/{zip}",
      "url": "https://apistead.qd.je/api/v1/us-zip/{zip}",
      "price_usdc": 0.001,
      "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235",
      "description": "Validate a US ZIP code and return city, state and coordinates.",
      "example_request": "GET https://apistead.qd.je/api/v1/us-zip/10001",
      "example_response": {
        "zip": "10001",
        "city": "New York",
        "state": "NY",
        "source": "zippopotam.us",
        "latitude": 40.7484,
        "longitude": -73.9967,
        "retrieved_at": "2026-11-09T20:00:00Z"
      },
      "verified": true,
      "last_checked_at": "2026-11-14T04:35:10.420Z",
      "latency_ms": 5,
      "uptime_30d": 87
    },
    {
      "method": "GET",
      "path": "/us-zip/distance?from={zip1}&to={zip2}",
      "url": "https://apistead.qd.je/api/v1/us-zip/distance?from={zip1}&to={zip2}",
      "price_usdc": 0.002,
      "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235",
      "description": "Great-circle distance between two US ZIP centroids.",
      "example_request": "GET https://apistead.qd.je/api/v1/us-zip/distance?from=10001&to=90210",
      "example_response": {
        "to": "90210",
        "from": "10001",
        "distance_km": 3944.2,
        "distance_miles": 2450.8
      },
      "verified": true,
      "last_checked_at": "2026-11-14T04:35:10.428Z",
      "latency_ms": 4,
      "uptime_30d": 87
    }
  ],
  "changelog": [
    {
      "version": "1.0.0",
      "title": "Initial verified release",
      "body": "The route is live and settlement-verified on Base mainnet. Health checks, public receipts and agent-readable records are available.",
      "type": "release",
      "author": "APIStead Labs",
      "published_at": "2026-11-11T16:54:23.719Z"
    }
  ],
  "generated_at": "2026-11-14T04:43:16.531Z"
}