> ## 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.

# API Response Schemas

> Output data structures

## Simulation Response

```typescript theme={null}
interface SimulationResponse {
  simulation_id: string;
  status: 'completed' | 'running' | 'failed';
  total_repurchase_obligation: number;
  peak_cash_year: number;
  peak_cash_amount: number;
  annual_projections: AnnualProjection[];
}

interface AnnualProjection {
  year: number;
  company_contribution: number;
  shares_released: number;
  repurchase_amount: number;
  ending_trust_cash: number;
}
```

See [API Introduction](/api-reference/introduction) for more details.