--- title: "GetRegionalSnapshot" method: GET path: "/api/intelligence/v1/get-regional-snapshot" tags: ["IntelligenceService"] --- # GetRegionalSnapshot `GET /api/intelligence/v1/get-regional-snapshot` ## Request - Base URL: `https://api.worldmonitor.app` - URL: `https://api.worldmonitor.app/api/intelligence/v1/get-regional-snapshot` - Auth: one of: - API key in header `X-WorldMonitor-Key` - API key in header `X-Api-Key` - HTTP bearer GetRegionalSnapshot returns the latest RegionalSnapshot for a region, refreshed every 6h. Premium-gated. PRO-gated. Requires an active Pro subscription. ## Query parameters - `region_id` string, required - `jmespath` string ## Response `200` OK - WorldmonitorIntelligenceV1GetRegionalSnapshotResponse: GetRegionalSnapshotResponse returns the latest RegionalSnapshot for the requested region. The snapshot is written by scripts/seed-regional-snapshots.mjs on a 6h cron; this handler only reads canonical state. - `snapshot` WorldmonitorIntelligenceV1RegionalSnapshot: RegionalSnapshot is the canonical intelligence object for one region. See docs/internal/pro-regional-intelligence-upgrade.md for the full spec and shared/regions.types.d.ts for the authoritative TypeScript contract. - `regionId` string - `generatedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript - `meta` WorldmonitorIntelligenceV1SnapshotMeta: SnapshotMeta carries the trust trail (versions, confidence, input freshness, narrative provenance, idempotency id). - `snapshotId` string - `modelVersion` string - `scoringVersion` string - `geographyVersion` string - `snapshotConfidence` number, double - `missingInputs` string[] - `staleInputs` string[] - `validUntil` integer: Warning: Values > 2^53 may lose precision in JavaScript - `triggerReason` string: trigger_reason: scheduled_6h | regime_shift | trigger_activation | corridor_break | leverage_shift - `narrativeProvider` string - `narrativeModel` string - `regime` WorldmonitorIntelligenceV1RegimeState: RegimeState captures the current regime label and transition history. - `label` string: label: calm | stressed_equilibrium | coercive_stalemate | fragmentation_risk | managed_deescalation | escalation_ladder - `previousLabel` string - `transitionedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript - `transitionDriver` string - `balance` WorldmonitorIntelligenceV1BalanceVector: BalanceVector is the 7-axis regional balance score with pressures/buffers split. See docs/internal/pro-regional-intelligence-appendix-scoring.md for the per-axis formulas. - `coercivePressure` number, double: Pressures (high = bad) - `domesticFragility` number, double - `capitalStress` number, double - `energyVulnerability` number, double - `allianceCohesion` number, double: Buffers (high = good) - `maritimeAccess` number, double - `energyLeverage` number, double - `netBalance` number, double: Derived: mean(buffers) - mean(pressures), range [-1, +1] - `pressures` WorldmonitorIntelligenceV1BalanceDriver[] - `axis` string - `description` string - `magnitude` number, double - `evidenceIds` string[] - `orientation` string: orientation: "pressure" | "buffer" - `buffers` WorldmonitorIntelligenceV1BalanceDriver[] - `axis` string - `description` string - `magnitude` number, double - `evidenceIds` string[] - `orientation` string: orientation: "pressure" | "buffer" - `actors` WorldmonitorIntelligenceV1ActorState[] - `actorId` string - `name` string - `role` string: role: aggressor | stabilizer | swing | broker - `leverageDomains` string[] - `leverageScore` number, double - `delta` number, double - `evidenceIds` string[] - `leverageEdges` WorldmonitorIntelligenceV1LeverageEdge[] - `fromActorId` string - `toActorId` string - `mechanism` string: mechanism: sanctions | naval_posture | energy_supply | alliance_shift | trade_friction - `strength` number, double - `evidenceIds` string[] - `scenarioSets` WorldmonitorIntelligenceV1ScenarioSet[] - `horizon` string: horizon: 24h | 7d | 30d - `lanes` WorldmonitorIntelligenceV1ScenarioLane[] - `name` string: name: base | escalation | containment | fragmentation - `probability` number, double - `triggerIds` string[] - `consequences` string[] - `transmissions` WorldmonitorIntelligenceV1TransmissionPath[] - `start` string - `mechanism` string - `end` string - `severity` string: severity: critical | high | medium | low - `corridorId` string - `confidence` number, double - `latencyHours` integer - `impactedAssetClass` string: impacted_asset_class: crude | lng | container | fx | equity | agri | metals | ... - `impactedRegions` string[] - `magnitudeLow` number, double - `magnitudeHigh` number, double - `magnitudeUnit` string: magnitude_unit: usd_bbl | pct | usd_teu | basis_points | ... - `templateId` string - `templateVersion` string - `transmissionPaths` WorldmonitorIntelligenceV1TransmissionPath[] - `start` string - `mechanism` string - `end` string - `severity` string: severity: critical | high | medium | low - `corridorId` string - `confidence` number, double - `latencyHours` integer - `impactedAssetClass` string: impacted_asset_class: crude | lng | container | fx | equity | agri | metals | ... - `impactedRegions` string[] - `magnitudeLow` number, double - `magnitudeHigh` number, double - `magnitudeUnit` string: magnitude_unit: usd_bbl | pct | usd_teu | basis_points | ... - `templateId` string - `templateVersion` string - `triggers` WorldmonitorIntelligenceV1TriggerLadder: TriggerLadder buckets triggers by activation state. - `active` WorldmonitorIntelligenceV1Trigger[] - `id` string - `description` string - `threshold` WorldmonitorIntelligenceV1TriggerThreshold: TriggerThreshold defines the metric/operator/value/window/baseline for deterministic trigger evaluation. - `metric` string - `operator` string: operator: gt | gte | lt | lte | delta_gt | delta_lt - `value` number, double - `windowMinutes` integer - `baseline` string: baseline: trailing_7d | trailing_30d | fixed - `activated` boolean - `activatedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript - `scenarioLane` string: scenario_lane: base | escalation | containment | fragmentation - `evidenceIds` string[] - `watching` WorldmonitorIntelligenceV1Trigger[] - `id` string - `description` string - `threshold` WorldmonitorIntelligenceV1TriggerThreshold: TriggerThreshold defines the metric/operator/value/window/baseline for deterministic trigger evaluation. - `metric` string - `operator` string: operator: gt | gte | lt | lte | delta_gt | delta_lt - `value` number, double - `windowMinutes` integer - `baseline` string: baseline: trailing_7d | trailing_30d | fixed - `activated` boolean - `activatedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript - `scenarioLane` string: scenario_lane: base | escalation | containment | fragmentation - `evidenceIds` string[] - `dormant` WorldmonitorIntelligenceV1Trigger[] - `id` string - `description` string - `threshold` WorldmonitorIntelligenceV1TriggerThreshold: TriggerThreshold defines the metric/operator/value/window/baseline for deterministic trigger evaluation. - `metric` string - `operator` string: operator: gt | gte | lt | lte | delta_gt | delta_lt - `value` number, double - `windowMinutes` integer - `baseline` string: baseline: trailing_7d | trailing_30d | fixed - `activated` boolean - `activatedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript - `scenarioLane` string: scenario_lane: base | escalation | containment | fragmentation - `evidenceIds` string[] - `mobility` WorldmonitorIntelligenceV1MobilityState: MobilityState captures airspace, flight corridor, and airport node status for the region. Phase 0 ships empty; Phase 2 wires the data plane. - `airspace` WorldmonitorIntelligenceV1AirspaceStatus[] - `airspaceId` string - `status` string: status: open | restricted | closed - `reason` string - `flightCorridors` WorldmonitorIntelligenceV1FlightCorridorStress[] - `corridor` string - `stressLevel` number, double - `reroutedFlights24h` integer - `airports` WorldmonitorIntelligenceV1AirportNodeStatus[] - `icao` string - `name` string - `status` string: status: normal | disrupted | closed - `disruptionReason` string - `rerouteIntensity` number, double - `notamClosures` string[] - `evidence` WorldmonitorIntelligenceV1EvidenceItem[] - `id` string - `type` string: type: vessel_track | flight_surge | news_headline | cii_spike | chokepoint_status | sanctions_move | market_signal | mobility_disruption - `source` string: source: AIS | ADSB | GDELT | ACLED | Yahoo | OREF | NOTAM | ... - `summary` string - `confidence` number, double - `observedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript - `theater` string - `corridor` string - `narrative` WorldmonitorIntelligenceV1RegionalNarrative: RegionalNarrative is the LLM-synthesized narrative layer. Every section links back to evidence via evidence_ids. - `situation` WM30: NarrativeSection is one block of narrative text plus its supporting evidence. - `text` string - `evidenceIds` string[] - `balanceAssessment` WM30: NarrativeSection is one block of narrative text plus its supporting evidence. - `text` string - `evidenceIds` string[] - `outlook24h` WM30: NarrativeSection is one block of narrative text plus its supporting evidence. - `text` string - `evidenceIds` string[] - `outlook7d` WM30: NarrativeSection is one block of narrative text plus its supporting evidence. - `text` string - `evidenceIds` string[] - `outlook30d` WM30: NarrativeSection is one block of narrative text plus its supporting evidence. - `text` string - `evidenceIds` string[] - `watchItems` WM30[] - `text` string - `evidenceIds` string[] ## Other responses - `400`: Validation error - `401`: Missing or invalid API key. - `403`: Pro subscription required. - `429`: Rate limit exceeded. - `503`: Service unavailable. Billing-verification responses include code and X-Billing-Verification; other gateway infrastructure failures use the generic GatewayError shape. - `default`: Gateway or handler error response. --- [API](https://skmtc.dev/worldmonitor/apis/worldmonitor-api.md) · [All operations](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/revisions/e3dc8463a5c9?raw)