Climate-health risk, as an API

What you can build

Authentication

Every request needs your API key in the X-API-Key header. Keys are issued by our team — email api@thehywing.com. All endpoints are under /v1/partner. Base URL: https://api.thehywing.com.

curl https://api.thehywing.com/v1/partner/health \
  -H "X-API-Key: hyk_your_key_here"

# → { "ok": true, "name": "Acme Insurance", "tier": "starter",
#     "rate_limit_per_min": 60, "monthly_quota": 50000,
#     "used_this_month": 128, "remaining_this_month": 49872 }

Rate limits are per key/minute and depend on your tier. Exceeding returns 429.

Plans & pricing

Each key has a monthly call quota and a per-minute rate limit. When you hit your monthly quota the API returns 429 until the next month or an upgrade. Check /v1/partner/health any time to see your usage and remaining calls.

Health risk at a location. Optional vulnerability flags sharpen the thresholds.

curl -X POST https://api.thehywing.com/v1/partner/climate-health/risk \
  -H "X-API-Key: hyk_your_key_here" -H "Content-Type: application/json" \
  -d '{ "latitude": 6.52, "longitude": 3.38, "indoors": false, "respiratory_condition": true }'

# → {
#   "overall_level": "high",
#   "weather": { "temp_c": 38.0, "feels_like_c": 42.0, "humidity_pct": 70, "aqi": 3, ... },
#   "risks": [
#     { "hazard": "heat", "level": "high", "score": 72.0,
#       "reasoning": "feels-like 42°C above threshold",
#       "guidance": [ { "title": "...", "message": "...", "severity": "high" } ] }
#   ]
# }

Work-rest / heat-safety recommendation for an occupation. occupation: farmer, rider, construction, guard, mechanic, general. ppe_type: none, light, heavy, encapsulated.

curl -X POST https://api.thehywing.com/v1/partner/occupational-safety \
  -H "X-API-Key: hyk_your_key_here" -H "Content-Type: application/json" \
  -d '{ "latitude": 9.08, "longitude": 7.4, "occupation": "construction", "ppe_type": "heavy" }'

# → { "score": 81.0, "level": "extreme", "recommendation": "Stop heavy work...", "weather": { ... } }

Active outbreak / disease signals for a country (ISO alpha-2).

curl "https://api.thehywing.com/v1/partner/outbreaks?country=NG" \
  -H "X-API-Key: hyk_your_key_here"

# → { "country": "NG", "count": 2, "outbreaks": [
#   { "disease": "Cholera", "severity": "high", "affected_regions": ["NG"],
#     "source": "NCDC", "source_url": "...", "updated_at": "..." } ] }

Agronomic indices + optional crop heat-stress and livestock THI. crop: maize, rice, sorghum, cassava… livestock: cattle, goat, poultry…

curl -X POST https://api.thehywing.com/v1/partner/agri-climate \
  -H "X-API-Key: hyk_your_key_here" -H "Content-Type: application/json" \
  -d '{ "latitude": 10.5, "longitude": 7.4, "crop": "maize", "livestock": "cattle" }'

# → {
#   "indices": { "growing_degree_days": 12.5, "et0_mm_day": 5.1, "field_work_score": 78, ... },
#   "crop": { "crop": "Maize (Corn)", "status": "heat_stress", "note": "Above 35°C — yield loss likely" },
#   "livestock": { "animal": "Cattle", "thi": 84.2, "stress_level": "severe", "recommended_actions": [ ... ] }
# }

Score up to 25 points for a regional risk map.

curl -X POST https://api.thehywing.com/v1/partner/climate-health/risk/batch \
  -H "X-API-Key: hyk_your_key_here" -H "Content-Type: application/json" \
  -d '{ "points": [
        { "latitude": 6.52, "longitude": 3.38, "label": "Lagos" },
        { "latitude": 9.08, "longitude": 7.40, "label": "Abuja" } ] }'

# → { "count": 2, "points": [ { "label": "Lagos", "overall_level": "high", "top_score": 72.0, ... } ] }