REST API Specification

Real-time PFAS risk scoring endpoints. All requests require an API key passed via the X-API-Key header.

Authentication

Include your API key in every request header:

header

X-API-Key: sk_live_abc123...def456

Base URL: https://api.climarisk.com

Rate Limits

Endpoint	Limit	Exceeded Response
POST /api/v2/pfas/screen	60 req/min	HTTP 429 + Retry-After header
GET /api/v2/pfas/sites	120 req/min	HTTP 429 + Retry-After header

Score a single property for PFAS financial risk. Accepts either a street address (geocoded via Google) or explicit latitude/longitude. Property value and loan balance are optional; when omitted, Census ACS county medians are used as fallback.

Request Body

Field	Type	Required	Description
address	string	optional	Street address. Geocoded to coordinates. Provide this OR lat/lon.
latitude	float	optional	Property latitude (WGS84). Use with longitude as alternative to address.
longitude	float	optional	Property longitude (WGS84). Use with latitude as alternative to address.
property_value	float	optional	Estimated property value in USD. Falls back to Census ACS county median.
loan_balance	float	optional	Current loan balance in USD. Falls back to 80% of property value.

Example Request

json

{
  "address": "1501 Blue Ball Rd, Elkton, MD 21921",
  "property_value": 385000,
  "loan_balance": 308000
}

curl

bash

curl -X POST https://api.climarisk.com/api/v2/pfas/screen \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_live_abc123...def456" \
  -d '{
    "address": "1501 Blue Ball Rd, Elkton, MD 21921",
    "property_value": 385000,
    "loan_balance": 308000
  }'

Response (200 OK)

json

{
  "pfas_risk_score": 72.4,
  "expected_loss_delta_bps": 18.3,
  "contamination_probability": 0.68,
  "proximity": {
    "nearest_site_dist_mi": 0.42,
    "nearest_confirmed_dist_mi": 0.42,
    "sites_within_1mi": 2,
    "sites_within_3mi": 5,
    "sites_within_5mi": 9,
    "nearest_site_type": "confirmed_contamination",
    "nearest_site_name": "W.L. Gore & Associates",
    "proximity_score": 85
  },
  "financial_impact": {
    "value_decline_pct": 0.064,
    "value_decline_usd": 24640,
    "adjusted_property_value": 360360,
    "original_ltv": 0.80,
    "adjusted_ltv": 0.854,
    "ltv_delta": 0.054,
    "pd_adjustment": 0.0081,
    "lgd_adjustment": 0.096,
    "expected_loss_before": 1540,
    "expected_loss_after": 3368,
    "expected_loss_delta": 1828,
    "expected_loss_delta_bps": 18.3,
    "cercla_risk": {
      "tier": 2,
      "tier_label": "Elevated",
      "description": "Within 1 mi of confirmed PFAS site with active CERCLA investigation",
      "estimated_remediation_exposure_usd": 45000
    }
  },
  "water_system": {
    "has_public_water": true,
    "pwsid": "MD0100012",
    "pws_name": "City of Elkton Water",
    "any_pfas_detected": true,
    "pfoa_detected": true,
    "pfos_detected": false,
    "serving_systems_count": 1
  },
  "latitude": 39.6068,
  "longitude": -75.8210,
  "property_value": 385000,
  "loan_balance": 308000,
  "data_quality": "user_provided",
  "water_system_coverage": "public_water_system",
  "model_coverage": "in_scope"
}