# Foresight Engine

> Sourced ten-year forecasts of insured losses for one driver, claim cause and geography, and a catalog of the technology ventures that mitigate them. Every number traces to an archived source and two named approvers. Read everything through a public, read-only JSON API with no key.

Foresight Engine is the application form of the VIG Claims-Tech Foresight Methodology, built for Vienna Insurance Group. Each run takes a scope (for example climate change driving flood damage to property in the EU, UK and Switzerland over 2025 to 2035) and produces a venture catalog, a ten-year insured-loss forecast with low and high bands, a sensitivity analysis and the evidence graph behind them.

## When to use Foresight Engine

- You need a list of companies and initiatives working on a specific insured loss (flood or wildfire damage to property in Europe today), with their country, impact channel (hazard, vulnerability or recovery), evidence tier and sources.
- You need a ten-year insured-loss trajectory for one of those scopes, before and after mitigating technology, with its uncertainty band and the parameters that move it most.
- You need to cite where a figure comes from: every value links to an archived snapshot (by SHA-256 digest) and to the research leads who signed it off.
- Do not use it for live market prices, insurance quotes, policy terms or claims about individual people. It holds none of those.

## How to call it

1. `GET https://foresight-engine.pages.dev/api/runs` lists every run with its scope, stage and counts. Pick a run `id`.
2. `GET /api/runs/{run_id}/ventures` returns the venture catalog; `/categories` the mitigation categories; `/forecast` the loss forecast; `/sensitivity` its drivers; `/evidence` the sources.
3. `GET /api/runs/{run_id}/snapshots/{digest}` returns the archived bytes of a cited source.
4. Any page of the site is also served as Markdown when you send `Accept: text/markdown`.

No authentication. JSON bodies are exactly what the engine's kernel returns. Writing (new runs, sign-offs, task replies) happens in the web app and is not part of the API.

## API

- [OpenAPI 3.1 document](https://foresight-engine.pages.dev/openapi.json): every endpoint with operationIds, parameters and response schemas, ready for function calling
- [API and agent guide](https://foresight-engine.pages.dev/docs): quickstart, endpoints, errors and limits
- [Engine health and version](https://foresight-engine.pages.dev/api/health): `GET /api/health`, operationId `getHealth`
- [List industry packs](https://foresight-engine.pages.dev/api/packs): `GET /api/packs`, operationId `listPacks`
- Get one industry pack: `GET https://foresight-engine.pages.dev/api/packs/{pack_id}`, operationId `getPack`
- [List forecast runs](https://foresight-engine.pages.dev/api/runs): `GET /api/runs`, operationId `listRuns`
- Get one run with its stages and sign-offs: `GET https://foresight-engine.pages.dev/api/runs/{run_id}`, operationId `getRun`
- List a run's venture catalog: `GET https://foresight-engine.pages.dev/api/runs/{run_id}/ventures`, operationId `listRunVentures`
- List a run's mitigation categories: `GET https://foresight-engine.pages.dev/api/runs/{run_id}/categories`, operationId `listRunCategories`
- Get a run's loss forecast: `GET https://foresight-engine.pages.dev/api/runs/{run_id}/forecast`, operationId `getRunForecast`
- Get a run's sensitivity analysis: `GET https://foresight-engine.pages.dev/api/runs/{run_id}/sensitivity`, operationId `getRunSensitivity`
- Get a run's evidence graph: `GET https://foresight-engine.pages.dev/api/runs/{run_id}/evidence`, operationId `getRunEvidence`
- Get a run's event log: `GET https://foresight-engine.pages.dev/api/runs/{run_id}/log`, operationId `getRunLog`
- List a run's agent tasks: `GET https://foresight-engine.pages.dev/api/runs/{run_id}/tasks`, operationId `listRunTasks`
- Get a run's methodology gate findings: `GET https://foresight-engine.pages.dev/api/runs/{run_id}/gates`, operationId `getRunGates`
- Get a run's category tiering check: `GET https://foresight-engine.pages.dev/api/runs/{run_id}/evals/tiering`, operationId `getRunTieringEval`
- [List agent tasks across all runs](https://foresight-engine.pages.dev/api/tasks): `GET /api/tasks`, operationId `listTasks`
- Download an archived source snapshot: `GET https://foresight-engine.pages.dev/api/runs/{run_id}/snapshots/{digest}`, operationId `getRunSnapshot`
- Download a venture's logo: `GET https://foresight-engine.pages.dev/api/runs/{run_id}/logos/{vid}`, operationId `getVentureLogo`
- Download a run's venture catalog workbook: `GET https://foresight-engine.pages.dev/api/runs/{run_id}/exports/catalog.xlsx`, operationId `downloadVentureCatalog`
- [Command-line client](https://foresight-engine.pages.dev/docs#command-line): run from the repository with Node 18 or later; `runs`, `ventures`, `forecast`, `evidence` and more, with `--json` for piping
- [Contacting the team](https://foresight-engine.pages.dev/docs#contacting-the-team): `POST /api/contact` with `name` and `message`; delivered privately to the research team

## Runs

- [Flood damage to property, Europe (EU + UK + CH)](https://foresight-engine.pages.dev/runs/2026-flooding-europe): Climate Change driving flood damage to property in Europe (EU + UK + CH); JSON at https://foresight-engine.pages.dev/api/runs/2026-flooding-europe; frozen 2026-05-22
- [Flood damage to property, Europe (EU + UK + CH)](https://foresight-engine.pages.dev/runs/2026-flooding-europe-catalog): Climate Change driving flood damage to property in Europe (EU + UK + CH); JSON at https://foresight-engine.pages.dev/api/runs/2026-flooding-europe-catalog
- [Flood damage to property, Europe (EU + UK + CH)](https://foresight-engine.pages.dev/runs/2026-flooding-europe-categories): Climate Change driving flood damage to property in Europe (EU + UK + CH); JSON at https://foresight-engine.pages.dev/api/runs/2026-flooding-europe-categories
- [Flood damage to property, Europe (EU + UK + CH)](https://foresight-engine.pages.dev/runs/2026-flooding-europe-matrix): Climate Change driving flood damage to property in Europe (EU + UK + CH); JSON at https://foresight-engine.pages.dev/api/runs/2026-flooding-europe-matrix; frozen 2026-06-07
- [Wildfire damage to property, Southern Europe (ES + PT + IT + GR)](https://foresight-engine.pages.dev/runs/2026-wildfire-southern-europe): Climate Change driving wildfire damage to property in Southern Europe (ES + PT + IT + GR); JSON at https://foresight-engine.pages.dev/api/runs/2026-wildfire-southern-europe

## About

- [About](https://foresight-engine.pages.dev/about): what the engine is and the methodology rules every number follows
- [Contact](https://foresight-engine.pages.dev/contact): who maintains it
- [Privacy](https://foresight-engine.pages.dev/privacy): what is stored, and where

## Optional

- [Full text of every page](https://foresight-engine.pages.dev/llms-full.txt)
- [Sitemap](https://foresight-engine.pages.dev/sitemap.xml)