Physical World Model

Structured JSON Physical World Model

Authenticated endpoint returning structured environmental context, source metadata, confidence concepts, and context_string for the coordinate.

get/api/v1/pwm

Request

  • Base URL: https://senlay.cloud
  • URL: https://senlay.cloud/api/v1/pwm
  • Auth: HTTP bearer

Query parameters

latnumber required

Latitude.

lngnumber required

Longitude.

fieldstring
Example:drone

Reasoning mode or use case.

Response

Structured physical-world context

statusstring
assessment_state'sufficient' | 'partial' | 'insufficient' | 'unknown'

Whether usable current evidence covers the groups required for the requested activity. Independent emergency signals can still produce a scored critical risk when environmental evidence is incomplete.

outcome'GO' | 'CAUTION' | 'NO_GO' | 'INSUFFICIENT_EVIDENCE'

GO: conditions within thresholds, evidence adequate. CAUTION: within thresholds but marginal, or a relevant unknown exists. NO_GO: a threshold is exceeded on adequate evidence. INSUFFICIENT_EVIDENCE: the evidence does not support any of the above; see unknowns for what is blocking the assessment. This is a normal, successful (HTTP 200) result, never an error.

active_sourcesinteger
total_sensorsinteger
extendedobject
context_stringstring

Example response

{
  "status": "ok",
  "contract": {
    "version": "2026-05-14"
  },
  "pwm": {
    "layers": {
      "atmosphere": {
        "current_source": {
          "source_type": "sensor",
          "mode": "hardware_first",
          "confidence": "low"
        }
      },
      "hydrosphere": {
        "current_source": {
          "source_type": "sensor",
          "mode": "hardware_first",
          "confidence": "low"
        }
      },
      "terrain": {
        "current_source": {
          "source_type": "sensor",
          "mode": "hardware_first",
          "confidence": "low"
        }
      },
      "air_quality": {
        "current_source": {
          "source_type": "sensor",
          "mode": "hardware_first",
          "confidence": "low"
        }
      }
    }
  },
  "evidence_summary": {
    "contract": {
      "version": "2026-05-14"
    }
  },
  "risk_summary": {
    "contract": {
      "version": "2026-05-14"
    },
    "max_severity": "none"
  },
  "risk_assessment": {
    "alert_band": {
      "id": "watch"
    }
  },
  "risk_events": [
    {
      "contract": {
        "version": "2026-05-14"
      },
      "type": "loss_of_power_drift_risk",
      "category": "water_safety",
      "status": "active"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.