# Research

> Research transparency surfaces for validation reports, claims, sources, predictions, backtests, and model health.

Research endpoints expose transparency artifacts for predictive-risk research. They are public read surfaces over promoted and client-visible research rows.

## Transparency Surfaces

### GET /v1/research/validation-reports

List validation reports.

| Parameter     | Type   | Default | Description             |
| ------------- | ------ | ------- | ----------------------- |
| model_version | string | -       | Filter by model version |
| limit         | number | -       | Max 100                 |

```bash
curl "https://api.philidor.io/v1/research/validation-reports?limit=5"
```

```json
{
  "data": [
    {
      "model_version": "severe-event-v1",
      "report_type": "validation",
      "published_at": "2026-07-01T00:00:00Z"
    }
  ]
}
```

### GET /v1/research/claims

List approved research claims.

| Parameter | Type   | Default | Description        |
| --------- | ------ | ------- | ------------------ |
| level     | string | public  | `public` or `beta` |
| surface   | string | -       | Surface filter     |
| limit     | number | -       | Max 100            |

```bash
curl "https://api.philidor.io/v1/research/claims?level=public"
```

### GET /v1/research/sources

List research sources.

| Parameter | Type   | Default | Description |
| --------- | ------ | ------- | ----------- |
| limit     | number | -       | Max 500     |

```bash
curl "https://api.philidor.io/v1/research/sources?limit=20"
```

## Research Preview

The following endpoints expose research artifacts under validation. Outputs are promotion-gated, subject to change, and not investment guidance.

### GET /v1/research/predictions

| Parameter | Type   | Default | Description        |
| --------- | ------ | ------- | ------------------ |
| vault_id  | string | -       | Vault filter       |
| outcome   | string | -       | Outcome name       |
| horizon   | string | -       | Prediction horizon |
| limit     | number | -       | Max 100            |

```bash
curl "https://api.philidor.io/v1/research/predictions?vault_id=morpho-1-0x..."
```

### GET /v1/research/backtests

| Parameter     | Type   | Default | Description   |
| ------------- | ------ | ------- | ------------- |
| model_version | string | -       | Model version |
| outcome       | string | -       | Outcome name  |
| limit         | number | -       | Max 100       |

```bash
curl "https://api.philidor.io/v1/research/backtests?model_version=severe-event-v1"
```

### GET /v1/research/model-health

| Parameter | Type   | Default | Description |
| --------- | ------ | ------- | ----------- |
| limit     | number | -       | Max 100     |

```bash
curl "https://api.philidor.io/v1/research/model-health?limit=10"
```