Physical World Model

Versioned physical-world evidence

Authenticated endpoint returning first-class evidence records with source provenance, trust role, freshness, quality, and cache metadata for a coordinate.

get/api/v1/evidence

Request

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

Query parameters

latnumber required

Latitude.

lngnumber required

Longitude.

fieldstring
Example:drone

Reasoning mode or use case.

Response

Evidence-backed physical-world context

statusstring
viewstring
fieldstring
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.

cacheobject
healthobject
evidence_recordobject

Example response

{
  "status": "ok",
  "contract": {
    "version": "2026-05-14"
  },
  "view": "evidence",
  "evidence": [
    {
      "id": "atmosphere.wind_speed",
      "schema_version": "2026-05-14",
      "provenance": {
        "normalized_record": {
          "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.