---
title: "Gets the AI-generated weekly cover summary for a patient's report window"
method: GET
path: "/patients/{patient_id}/insights/weekly-cover-summary"
tags: ["insights"]
---

# Gets the AI-generated weekly cover summary for a patient's report window

`GET /patients/{patient_id}/insights/weekly-cover-summary`

## 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
- `force_rebuild` boolean — force the rebuild of the weekly cover summary

## Response `200`

successful operation

- PatientInsightsWeeklyCoverSummaryResponse
  - `behavior_patterns` string[]
  - `date_since` string, date, required — window start date
  - `date_until` string, date, required — window end date
  - `diet_quality_overview` string, required — brief diet-quality interpretation for the week
  - `executive_summary` string, required — 3-4 sentence executive summary for the week
  - `id` integer — id of the weekly cover summary
  - `internal_reasoning` string, nullable — internal reasoning for the weekly summary, in English
  - `meal_insights` PatientInsightsWeeklyCoverMealInsightResponse[]
    - `insight` string, required — patient-facing meal insight
    - `meal_id` integer, required — selected meal id
  - `pinned_nutrient_insights` PatientInsightsWeeklyCoverPinnedNutrientInsightResponse[]
    - `insight` string, required — patient-facing insight for this pinned nutrient
    - `nutrient_key` string, required — machine-readable nutrient key
  - `recommended_challenge` PatientInsightsWeeklyCoverRecommendedChallengeResponse
    - `challenge_id` string, required — recommended challenge id
    - `challenge_name` string, required — display name of the challenge
    - `rationale` string, required — short rationale for the challenge recommendation
  - `suggested_questions` string[]
  - `version` string, required — version of the weekly cover summary response

## Other responses

- `400` — invalid request
- `404` — no report exists for the selected date range

---

[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/a229b18839a0?raw)