---
title: "Query the patient's Mediterranean score history over a time period"
method: GET
path: "/metrics/patients/{patient_id}/mediterranean/history"
tags: ["metrics"]
---

# Query the patient's Mediterranean score history over a time period

`GET /metrics/patients/{patient_id}/mediterranean/history`

## Path parameters

- `patient_id` integer, required

## Query parameters

- `date_since` string, required — calendar date in format YYYY-MM-DD
- `date_until` string, required — calendar date in format YYYY-MM-DD
- `window_days` integer — rolling window size in days; allowed range 1..30
- `version` '1' | '2' — algorithm version; if omitted, auto-select based on patient_app_use_v3_ui flag

## Response `200`

successful operation

- MediterraneanScoreHistoryResponse
  - `daily_mediterranean_scores` MediterraneanScoreHistoryRowResponse[], required — Full day series from date_since..date_until, sorted ascending by log_date.
    - `has_data` boolean, required
    - `log_date` string, required — calendar date in format YYYY-MM-DD
    - `max_score` number, required
    - `total_score` number, nullable, required
    - `window_end_date` string, required — calendar date in format YYYY-MM-DD
    - `window_start_date` string, required — calendar date in format YYYY-MM-DD
  - `date_since` string, required — calendar date in format YYYY-MM-DD
  - `date_until` string, required — calendar date in format YYYY-MM-DD
  - `patient_id` integer, required
  - `version` '1' | '2', required
  - `window_days` integer, required

## Other responses

- `400` — invalid request
- `401` — unauthorized
- `403` — forbidden
- `404` — patient not found
- `422` — unprocessable request

---

[API](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server.md) · [All operations](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server/llms.txt) · [OpenAPI document](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server/revisions/a61b77b30e63?raw)