API preview

Developer docs

Lotmark is currently accepting waitlist signups for the Sonoma County pilot API. The public Vercel frontend proxies waitlist API requests to the Railway backend; the parcel intelligence API runs as a separate protected service from services/parcel-api.

Waitlist endpoint

POST /api/waitlist
Content-Type: application/json

{
  "email": "you@company.com",
  "name": "Your Name",
  "company": "Company",
  "role": "proptech-ai",
  "plan": "builder",
  "message": "What you are building",
  "request_demo": true
}

Parcel API endpoint

Use the parcel API base URL, not the landing app URL. Customer requests require a bearer API key.

GET /v1/parcels/lm_06097_079-020-011
Authorization: Bearer LOTMARK_API_KEY

{
  "parcel_id": "lm_06097_079-020-011",
  "freshness_days": 17,

  "parcel": {
    "apn": "079-020-011",
    "address": "10275 Loch Haven Dr, Santa Rosa, CA",
    "land_acres": 1.02,
    "source": {
      "agency": "County of Sonoma",
      "product": "Parcels Public",
      "as_of": "2026-05-02"
    }
  },

  "risk_features": {
    "fire": {
      "fhsz_zone": "High",
      "responsibility_area": "SRA",
      "source": {
        "agency": "CAL FIRE",
        "product": "SRA Fire Hazard Severity Zones",
        "effective": "2024-04-01"
      },
      "confidence": 0.95
    },
    "flood": {
      "fema_zone": "X",
      "in_sfha": false,
      "source": {
        "agency": "FEMA NFHL",
        "panel_id": "06097C0735F"
      }
    }
  },

  "building": {
    "primary_year_built": 1979,
    "primary_size_sqft": 2839,
    "source": {
      "agency": "County of Sonoma",
      "product": "Parcels Public",
      "as_of": "2026-05-02"
    }
  },

  "terrain": {
    "elevation_ft": 589,
    "local_relief_150m_ft": 85,
    "source": {
      "agency": "USGS",
      "product": "3DEP 1m DEM"
    }
  },

  "narrative": {
    "text": "This 1.02-acre rural residential parcel is in CAL FIRE's High SRA Fire Hazard Severity Zone, with a 1979 primary structure and 589-foot USGS 3DEP elevation.",
    "grounded_in": ["parcel", "building", "terrain", "risk.fire"]
  },

  "embedding": {
    "dim": 1536,
    "model": "text-embedding-3-small",
    "status": "metadata_only"
  }
}

Operations

Health check: /api/health

CSV export is available at /api/waitlist/export when the Railway backend has WAITLIST_ADMIN_TOKEN configured. Send it as Authorization: Bearer YOUR_TOKEN.