Generate a Meal Plan

At any point in time, you can make adjustments to the meal plan settings and schedule, and replace your existing meal plan with a new one.
Note: To use the Whisk Meal Plan API, you must acquire a User Token. For more information, see User Access Tokens.
The Meal Plan API provides you two endpoints that allow you to generate a meal plan. The only difference between the two is that one of them requires a {meal_plan_id} and the other doesn't. This arrangement has been made for a future planned feature of supporting multiple meal plans for every user.
While at the moment, since Whisk only supports a single meal plan per user, the  {meal_plan_id} has been kept optional for both endpoints. You can leave it blank and it would be directly derived from the user token being used for API authentication.
put
Generate a meal plan
https://api.whisk.com/mealplan/v2/generate
This endpoint allows you to regenerate a meal plan using the Body parameter.
Request
Response
Request
Body Parameters
body
required
object
This parameter allows you to specify the settings,  schedule, and preferences for the new meal plan. For more information, see the Request Body Object Example below.
Response
200: OK
This how a successful meal plan response looks like. To understand its data structure, see the Meal Plan API topic.
{
  "meal_plan_id": "5f27a59a9a8641078c7057eeec0a1b90",
  "start_date": 
    ...
  "end_date":
    ...
  "meals": [
    {
      "id": "894f285cd9d543d3b78b374f59b56311",
      "meal_type": "MEAL_TYPE_BREAKFAST",
      "date_time":
        ...
      "content": {
        "recipe": 
          ...
      },
      "generated": true,
      "day_slot": 3,
      "date":
        ...
    },
    {
      "id": "aab8f93131724117836f8cab365518c6",
      "meal_type": "MEAL_TYPE_LUNCH",
      "date_time":
        ...
      "content": {
        "recipe": 
          ...
      },
      "generated": true,
      "day_slot": 4,
      "date":
        ...
    },
    {
      "id": "4b50cf3d2bf24ebe9c4630d2816fea99",
      "meal_type": "MEAL_TYPE_DINNER",
      "date_time":
        ...
      "content": {
        "recipe": 
          ...
      },
      "generated": true,
      "day_slot": 5,
      "date":
        ...
    },
    ...
  ],
  "result_code": "GENERATION_RESULT_CODE_SUCCESS"
}
400: Bad Request
This failed response appears when specific error codes are found in the endpoint description.
{
  "error_code": "REAL_CODES_ARE_IN_ENDPOINT_DESCRIPTION",
  "message": "Additional details about error are not static and can be changed"
}
401: Unauthorized
This failed response appears when API authentication gets failed. The possible error codes that may appear are: auth.tokenNotFound auth.tokenExpired auth.tokenInvalid auth.tokenRequired
{
  "code": "auth.tokenNotFound"
}
500: Internal Server Error
This failed response appears when something is not right at Whisk's end.
This is unexpected response, something is wrong on our side, please contact: [email protected].com
Note: Whisk provides its APIs on the Swagger interface for you to try it out. You can call this endpoint here.
put
Generate a specific meal plan
https://api.whisk.com/mealplan/v2/{meal_plan_id}/generate
This endpoint allows you to regenerate a meal plan using the meal_plan_id path parameter (currently optional) and the body parameter.
Request
Response
Request
Path Parameters
meal_plan_id
required
string
The meal plan identifier.
Body Parameters
body
required
object
This parameter allows you to specify the settings,  schedule, and preferences for the new meal plan. For more information, see the Request Body Object Example below.
Response
200: OK
This how a successful meal plan response looks like. To understand its data structure, see the Meal Plan API topic.
{
  "meal_plan_id": "5f27a59a9a8641078c7057eeec0a1b90",
  "start_date": 
    ...
  "end_date":
    ...
  "meals": [
    {
      "id": "894f285cd9d543d3b78b374f59b56311",
      "meal_type": "MEAL_TYPE_BREAKFAST",
      "date_time":
        ...
      "content": {
        "recipe": 
          ...
      },
      "generated": true,
      "day_slot": 3,
      "date":
        ...
    },
    {
      "id": "aab8f93131724117836f8cab365518c6",
      "meal_type": "MEAL_TYPE_LUNCH",
      "date_time":
        ...
      "content": {
        "recipe": 
          ...
      },
      "generated": true,
      "day_slot": 4,
      "date":
        ...
    },
    {
      "id": "4b50cf3d2bf24ebe9c4630d2816fea99",
      "meal_type": "MEAL_TYPE_DINNER",
      "date_time":
        ...
      "content": {
        "recipe": 
          ...
      },
      "generated": true,
      "day_slot": 5,
      "date":
        ...
    },
    ...
  ],
  "result_code": "GENERATION_RESULT_CODE_SUCCESS"
}
400: Bad Request
This failed response appears when specific error codes are found in the endpoint description.
{
  "error_code": "REAL_CODES_ARE_IN_ENDPOINT_DESCRIPTION",
  "message": "Additional details about error are not static and can be changed"
}
401: Unauthorized
This failed response appears when API authentication gets failed. The possible error codes that may appear are: auth.tokenNotFound auth.tokenExpired auth.tokenInvalid auth.tokenRequired
{
  "code": "auth.tokenNotFound"
}
500: Internal Server Error
This failed response appears when something is not right at Whisk's end.
This is unexpected response, something is wrong on our side, please contact: [email protected].com
Note: Whisk provides its APIs on the Swagger interface to try and test. You can call this endpoint here.
Request Body Object Example
Curl Call Example
Request Body Object Example
{
  "meal_plan_id": "string",
  "settings": {
    ...
  },
  "period": {
    ...
  },
  "fields": [
    ...
  ]
}
The body object contains the following attributes and arrays that can be set to generate a meal plan for you:
Attribute
Type
Description
Example Value
meal_plan_id
string
The meal-plan identifier. You can skip it when using an Access Token for API authentication.
5f27a59a9a8641078c7057eeec0a1b90
settings
array
This includes all the core settings based on which you want to create your meal plan like - the number of servings, caloric goals, effective days, generation algorithm, food preferences, labels, etc.
See Meal Plan Settings.
period
array
The time period that the meal plan needs to cover.
"period": { 
    "from": { 
       "year": 2020, 
       "month": 10, 
       "day": 1 
    },
    "to": { 
      "year": 2020,
      "month": 10, 
      "day": 10
     }
  },
fields
string
Any additional recipe information you may want to include in your plan.
RECIPE_FIELD_NORMALIZED_INGREDIENTS
RECIPE_FIELD_INSTRUCTIONS
RECIPE_FIELD_NUTRITION 
RECIPE_FIELD_INGREDIENTS_LINKED_PRODUCTS
Curl Call Example
curl -X POST "https://api.whisk.com/mealplan/v2/generate" 
     -H  "accept: application/json" 
     -H "Authorization: Token <Access-Token>" 
     -H  "Content-Type: application/json" 
     -d "{  \"settings\": {    \"servings\": 1,    \"calorie_per_day\": 2000,    \"enabled_auto_generation\": true,    \"replace_only_generated\": true  },  \"period\": {    \"from\": {      \"year\": 2020,      \"month\": 10,      \"day\": 1    },    \"to\": {      \"year\": 2020,      \"month\": 10,      \"day\": 10    }  },  \"fields\": [    \"RECIPE_FIELD_INVALID\"  ]}"
​

Whisk API Reference 2.0 - Previous

Meal Plan

Meal Object

Last updated 4 months ago

Attribute	Type	Description	Example Value
`meal_plan_id`	string	The meal-plan identifier. You can skip it when using an Access Token for API authentication.	`5f27a59a9a8641078c7057eeec0a1b90`
`settings`	array	This includes all the core settings based on which you want to create your meal plan like - the number of servings, caloric goals, effective days, generation algorithm, food preferences, labels, etc.	See Meal Plan Settings.
`period`	array	The time period that the meal plan needs to cover.	`"period": {` `"from": {` `"year": 2020,` `"month": 10,` `"day": 1` `},` `"to": {` `"year": 2020,` `"month": 10,` `"day": 10` `}` `},`
`fields`	string	Any additional recipe information you may want to include in your plan.	`RECIPE_FIELD_NORMALIZED_INGREDIENTS` `RECIPE_FIELD_INSTRUCTIONS` `RECIPE_FIELD_NUTRITION` `RECIPE_FIELD_INGREDIENTS_LINKED_PRODUCTS`

Generate a Meal Plan

putGenerate a meal plan

putGenerate a specific meal plan

put
Generate a meal plan

put
Generate a specific meal plan