---
title: "Get Meal Plan Week"
method: GET
path: "/mealplanner/{username}/week/{start-date}"
tags: ["meal planning"]
---

# Get Meal Plan Week

`GET /mealplanner/{username}/week/{start-date}`

Retrieve a meal planned week for the given user. The username must be a spoonacular user and the hash must the the user's hash that can be found in his/her account.

## Path parameters

- `username` string, required
- `start-date` string, required

## Query parameters

- `hash` string, required

## Response `200`

Success

- object
  - `days` object[], required
    - `nutritionSummary` object
      - `nutrients` object[], required
        - `name` string, required
        - `amount` number, required
        - `unit` string, required
        - `percentDailyNeeds` number, required
    - `nutritionSummaryBreakfast` object
      - `nutrients` object[], required
        - `name` string, required
        - `amount` number, required
        - `unit` string, required
        - `percentDailyNeeds` number, required
    - `nutritionSummaryLunch` object
      - `nutrients` object[], required
        - `name` string, required
        - `amount` number, required
        - `unit` string, required
        - `percentDailyNeeds` number, required
    - `nutritionSummaryDinner` object
      - `nutrients` object[], required
        - `name` string, required
        - `amount` number, required
        - `unit` string, required
        - `percentDailyNeeds` number, required
    - `date` number, required
    - `day` string, required
    - `items` object[]
      - `id` integer, required
      - `slot` integer, required
      - `position` integer, required
      - `type` string, required
      - `value` object
        - `servings` number, required
        - `id` number, required
        - `title` string, required
        - `imageType` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/spoonacular/apis/spoonacular-api.md) · [All operations](https://skmtc.net/spoonacular/apis/spoonacular-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spoonacular/spoonacular-api/versions/bc2fbe4e8981/schema)