---
title: "Meals of the consenting patient for a date range"
method: GET
path: "/partner/me/meals"
tags: ["partner-oauth"]
---

# Meals of the consenting patient for a date range

`GET /partner/me/meals`

## Query parameters

- `date_since` string, date, required
- `date_until` string, date, required

## Response `200`

List of meals (same restricted projection as the API-key route)

- PartnerApiMeal[]
  - `created_time` string, date-time, nullable, required
  - `id` integer, required
  - `meal_date` string, date, required
  - `meal_items` PartnerApiMealItem[], required
    - `created_time` string, date-time, nullable, required
    - `custom_addons` PartnerApiMealCustomAddon[], required
      - `created_time` string, date-time, nullable, required
      - `food_name` string, required — Display name (food_name_alias when set, otherwise food_name).
      - `id` integer, required
      - `nutrients` PartnerApiMealItemNutrients, required — Enforced partner-facing nutrient map for each meal line item and custom add-on. Exactly these keys are returned (numeric values, or null). This contract is security-sensitive; changes require explicit review before release. Align with ``_MEAL_ITEM_NUTRIENT_COLUMN_NAMES`` in ``app/api/partner_api/meal_projection.py``.
        - `added_sugars_g` number, nullable, required
        - `alcohol_g` number, nullable, required
        - `caffeine_mg` number, nullable, required
        - `calcium_mg` number, nullable, required
        - `carbohydrate_g` number, nullable, required
        - `cholesterol_mg` number, nullable, required
        - `choline_mg` number, nullable, required
        - `energy_kcal` number, nullable, required
        - `fat_g` number, nullable, required
        - `fattyacids_totalmonounsaturated_g` number, nullable, required
        - `fattyacids_totalpolyunsaturated_g` number, nullable, required
        - `fattyacids_totalsaturated_g` number, nullable, required
        - `fattyacids_totaltrans_g` number, nullable, required
        - `fiber_g` number, nullable, required
        - `folate_dfe_ug` number, nullable, required
        - `insoluble_dietary_fiber_g` number, nullable, required
        - `iron_mg` number, nullable, required
        - `magnesium_mg` number, nullable, required
        - `netcarb_g` number, nullable, required
        - `niacin_mg` number, nullable, required
        - `omega_three_fatty_acids_g` number, nullable, required
        - `pantothenic_acid_mg` number, nullable, required
        - `phosphorus_mg` number, nullable, required
        - `polyols_g` number, nullable, required
        - `potassium_mg` number, nullable, required
        - `protein_g` number, nullable, required
        - `riboflavin_mg` number, nullable, required
        - `selenium_mcg` number, nullable, required
        - `sodium_mg` number, nullable, required
        - `soluble_dietary_fiber_g` number, nullable, required
        - `sugars_g` number, nullable, required
        - `thiamin_mg` number, nullable, required
        - `vitamin_a_iu` number, nullable, required
        - `vitamin_a_rae_ug` number, nullable, required
        - `vitamin_b12_ug` number, nullable, required
        - `vitamin_b6_mg` number, nullable, required
        - `vitamin_c_mg` number, nullable, required
        - `vitamin_d2d3_ug` number, nullable, required
        - `vitamin_d_iu` number, nullable, required
        - `vitamin_e_mg` number, nullable, required
        - `vitamin_k_ug` number, nullable, required
        - `water_g` number, nullable, required
        - `zinc_mg` number, nullable, required
      - `sizing` PartnerApiMealItemSizing, required — Portion and unit fields for a meal line item (no CC classification).
        - `net_serving_size_g` number, nullable
        - `percent_eaten` number, nullable
        - `serving_unit_amount` number, nullable
        - `serving_unit_label` string, nullable
        - `servings` number, nullable
      - `updated_time` string, date-time, nullable, required
    - `food_name` string, required — Display name (food_name_alias when set, otherwise food_name).
    - `id` integer, required
    - `nutrients` PartnerApiMealItemNutrients, required — Enforced partner-facing nutrient map for each meal line item and custom add-on. Exactly these keys are returned (numeric values, or null). This contract is security-sensitive; changes require explicit review before release. Align with ``_MEAL_ITEM_NUTRIENT_COLUMN_NAMES`` in ``app/api/partner_api/meal_projection.py``.
      - `added_sugars_g` number, nullable, required
      - `alcohol_g` number, nullable, required
      - `caffeine_mg` number, nullable, required
      - `calcium_mg` number, nullable, required
      - `carbohydrate_g` number, nullable, required
      - `cholesterol_mg` number, nullable, required
      - `choline_mg` number, nullable, required
      - `energy_kcal` number, nullable, required
      - `fat_g` number, nullable, required
      - `fattyacids_totalmonounsaturated_g` number, nullable, required
      - `fattyacids_totalpolyunsaturated_g` number, nullable, required
      - `fattyacids_totalsaturated_g` number, nullable, required
      - `fattyacids_totaltrans_g` number, nullable, required
      - `fiber_g` number, nullable, required
      - `folate_dfe_ug` number, nullable, required
      - `insoluble_dietary_fiber_g` number, nullable, required
      - `iron_mg` number, nullable, required
      - `magnesium_mg` number, nullable, required
      - `netcarb_g` number, nullable, required
      - `niacin_mg` number, nullable, required
      - `omega_three_fatty_acids_g` number, nullable, required
      - `pantothenic_acid_mg` number, nullable, required
      - `phosphorus_mg` number, nullable, required
      - `polyols_g` number, nullable, required
      - `potassium_mg` number, nullable, required
      - `protein_g` number, nullable, required
      - `riboflavin_mg` number, nullable, required
      - `selenium_mcg` number, nullable, required
      - `sodium_mg` number, nullable, required
      - `soluble_dietary_fiber_g` number, nullable, required
      - `sugars_g` number, nullable, required
      - `thiamin_mg` number, nullable, required
      - `vitamin_a_iu` number, nullable, required
      - `vitamin_a_rae_ug` number, nullable, required
      - `vitamin_b12_ug` number, nullable, required
      - `vitamin_b6_mg` number, nullable, required
      - `vitamin_c_mg` number, nullable, required
      - `vitamin_d2d3_ug` number, nullable, required
      - `vitamin_d_iu` number, nullable, required
      - `vitamin_e_mg` number, nullable, required
      - `vitamin_k_ug` number, nullable, required
      - `water_g` number, nullable, required
      - `zinc_mg` number, nullable, required
    - `sizing` PartnerApiMealItemSizing, required — Portion and unit fields for a meal line item (no CC classification).
      - `net_serving_size_g` number, nullable
      - `percent_eaten` number, nullable
      - `serving_unit_amount` number, nullable
      - `serving_unit_label` string, nullable
      - `servings` number, nullable
    - `updated_time` string, date-time, nullable, required
  - `meal_name` 'breakfast' | 'lunch' | 'dinner' | 'snack', required
  - `meal_time` string, required — time in format hh:mm:ss
  - `updated_time` string, date-time, nullable, required

## Other responses

- `400` — Invalid date format or range
- `401` — Invalid, expired or revoked delegated token
- `403` — Missing meals:read scope

---

[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-service-production.skmtc.workers.dev/v1/apis/rxfoodapp/inneranalytics-mnt-server/revisions/f06884d9c093/schema)