# Symptom Stats

Use the `symptomStats` to retrieve statistics for symptoms logged by the user within a specified date range.

### Required Arguments

| Argument | Type      | Description                                                        |
| -------- | --------- | ------------------------------------------------------------------ |
| `start`  | DateTime! | The starting date for the date range. Use the format: `YYYY-MM-DD` |
| `end`    | DateTime! | The end date for the date range. Use the format: `YYYY-MM-DD`      |

### Available Fields

| Field Name  | Type    | Description                                      |
| ----------- | ------- | ------------------------------------------------ |
| `symptomId` | ID      | Symptom Id.                                      |
| `symptom`   | Symptom | [Symptom](/graphql/objects/symptoms/symptom.md). |
| `count`     | Int     | Number of times the symptom was reported.        |
| `total`     | Float   | Total value accumulated for the symptom.         |
| `average`   | Float   | Average value of the symptom reports.            |
| `min`       | Float   | Minimum value reported for the symptom.          |
| `max`       | Float   | Maximum value reported for the symptom.          |

### Example

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

```graphql
query{
  symptomStats(start:"2025-07-02" end:"2025-07-04"){
    symptomId
    symptom{
      id
      name
    }
    count
    total
    average
    min
    max
  }
}
```

{% endtab %}

{% tab title="Response" %}

```graphql
{
  "data": {
    "symptomStats": [
      {
        "symptomId": "U3ltcHRvbTozNGNlYjBkZC05ZTg4LTQ0OWYtODcwNC05ZjJlMmU2MGRiNDE=",
        "symptom": {
          "id": "U3ltcHRvbTozNGNlYjBkZC05ZTg4LTQ0OWYtODcwNC05ZjJlMmU2MGRiNDE=",
          "name": "Bloating"
        },
        "count": 3,
        "total": 10,
        "average": 3.3333333333333335,
        "min": 2,
        "max": 5
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: 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:

```
GET https://docs.suggestic.com/graphql/query/queries/tracking/symptoms/symptom-stats.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.