> For the complete documentation index, see [llms.txt](https://docs.suggestic.com/graphql/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suggestic.com/graphql/objects/meal-plan/simple-meal-plan-filters.md).

# Simple Meal Plan Filters

The `filters` object filters and create a simple meal plan with specific information such as *caloric range* and *tags* per each meal plan, meaning `breakfast`, `lunch`, `snack`, and `dinner`. For instance, it is possible to create a filter that returns all the recipes tagged with "keto" and with a specific range of calories. 

It is not necessary to define all the meal times for each filter. For instance, if the following filter is defined:

```graphql
filters: {
      kcalRange: {
        breakfast: { min: 100, max: 500 }
        lunch: { min: 100, max: 400 }
        }
  }
```

The caloric range will be only applied to `breakfast` and `lunch`, while `snack` and `dinner` will be created with no caloric range.

**Note:** Use this in the [`generateSimpleMealPlan`](https://docs.suggestic.com/graphql/query/mutations/meal-plan/generate-simple-meal-plan) only.

## Available fields

| **Field Name** | **Type**                  | **Description**                                                                                                                                                                                                                                                                                                                                                                               |
| :------------: | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   `kcalRange`  | RangeByMealTimeInput      | <p>Include the minimun (<code>min</code>) and maximum (<code>max</code>) range of calories pear each meal time. Use the following meal time:<br><strong><code>breakfast</code></strong><br><strong><code>lunch</code></strong><br><strong><code>snack</code></strong><br><strong><code>dinner</code></strong><br>i.e. breakfast should only use recipes with 300-500 calories per serving</p> |
|     `tags`     | TermValuesByMealTimeInput | <p>Predefined tag to be added to use it to filter a meal time Add one or more tags. <br><br>Use the following meal time:<br><strong><code>breakfast</code></strong><br><strong><code>lunch</code></strong><br><strong><code>snack</code></strong><br><strong><code>dinner</code></strong><br>i.e. snacks should only use recipes tagged "salad" or "smoothie"</p>                             |

## Examples

### How to use calorie range and tags

{% tabs %}
{% tab title="Example" %}

```graphql
filters: {
      kcalRange: {
        breakfast: { min: 100, max: 500 }
        lunch: { min: 100, max: 400 }
        snack: { min: 100, max: 300 }
        dinner: { min: 100, max: 400 }
      }
      tags: {
        breakfast: ["healthy"]
        lunch: ["delicious"]
        snack: ["salad"]
        dinner: ["delicious"]
      }
    }
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.suggestic.com/graphql/objects/meal-plan/simple-meal-plan-filters.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.