> ## Documentation Index
> Fetch the complete documentation index at: https://village-docs.villagelabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /simulate

> Run a new ESOP simulation

## Request

```json theme={null}
{
  "planRules": { },
  "operatingAssumptions": { },
  "initialState": { },
  "systemConfig": { }
}
```

## Response

```json theme={null}
{
  "success": true,
  "data": {
    "simulation_id": "sim_2024_001",
    "status": "completed",
    "results": {
      "total_repurchase_obligation": 8450000,
      "peak_cash_year": 2029,
      "annual_projections": [ ]
    }
  }
}
```

See [Quick Start](/quickstart) for complete example.