> 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/query/queries/assessments/user-assessments.md).

# User Assessments

Use the `userAssessments` query to return all assessments assigned to the user.

### Available Arguments

|                       |                            |                                                                                                        |
| --------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Argument**          | **Type**                   | **Description**                                                                                        |
| `after`               | String                     | See [pagination](https://docs.suggestic.com/graphql/start-here/tutorials-and-walkthroughs/pagination). |
| `before`              | String                     | See [pagination](https://docs.suggestic.com/graphql/start-here/tutorials-and-walkthroughs/pagination). |
| `first`               | Int                        | Retrieves the first results from the list.                                                             |
| `last`                | Int                        | See [pagination](https://docs.suggestic.com/graphql/start-here/tutorials-and-walkthroughs/pagination). |
| `filters`             | UserAssessmentsFilterInput |                                                                                                        |
| `filters.description` | String                     | Filters by Assessment description.                                                                     |
| `filters.status`      | AssessmentStatus           | enum AssessmentStatus {**DONE**, **IN\_PROGRESS**, **NEEDS\_UPDATE**, **TODO**}                        |
| `filters.title`       | String                     | Filters by Assessment title.                                                                           |

### Available Fields

|                     |                    |                                                                                                                                                   |
| ------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Field**           | **Type**           | **Description**                                                                                                                                   |
| `createdAt`         | DateTime!          | Assessment creation date `YYYY-MM-DDT hh:mm:ssZ`                                                                                                  |
| `description`       | String             | Description of the assessment.                                                                                                                    |
| `finalQuestion`     | AssessmentQuestion | Assessment final [question](https://app.gitbook.com/o/-LwqSh0rNboNaGEQruZQ/s/-LwqSnBDpAb6mFZYLsuB/~/changes/1878/objects/assessments/question).   |
| `hasScore`          | Boolean            | **True** if the assessment has a score system in set, otherwise **False**.                                                                        |
| `icon`              | String             | Url of the assessment Icon.                                                                                                                       |
| `id`                | ID!                | Id of the assessment.                                                                                                                             |
| `initialQuestion`   | AssessmentQuestion | Assessment initial [question](https://app.gitbook.com/o/-LwqSh0rNboNaGEQruZQ/s/-LwqSnBDpAb6mFZYLsuB/~/changes/1878/objects/assessments/question). |
| `interval`          | Int                | Assessment intervals defined in days.                                                                                                             |
| `isDraft`           | Boolean!           | **True** if the assessment is Draft, otherwise **False**.                                                                                         |
| `isPublic`          | Boolean!           | **True** if the assessment is Public, otherise **False**.                                                                                         |
| `order`             | Int!               | Defines assessment order.                                                                                                                         |
| `progressBar`       | Boolean!           | If set to **True** the assessment will show a progress bar in top of the screen (Whitelabel), otherwise **False**.                                |
| `questions`         | AssessmentQuestion | Assessment [Questions](https://app.gitbook.com/o/-LwqSh0rNboNaGEQruZQ/s/-LwqSnBDpAb6mFZYLsuB/~/changes/1878/objects/assessments/question).        |
| `questions.answers` | AssessmentAnswer   | Assessment [Answer](https://app.gitbook.com/o/-LwqSh0rNboNaGEQruZQ/s/-LwqSnBDpAb6mFZYLsuB/~/changes/1881/objects/assessments/answer).             |
| `score`             | Float              | Displays total score. (Sums all the answers with a score)                                                                                         |
| `status`            | AssessmentStatus   | enum AssessmentStatus {**DONE, IN\_PROGRESS, NEEDS\_UPDATE, TODO**}                                                                               |
| `title`             | String!            | Title of the assessment.                                                                                                                          |
| `updatedAt`         | DateTime!          | Assessment last update date `YYYY-MM-DDT hh:mm:ssZ`                                                                                               |
| `weight`            | Int                | Whitelabel feature.                                                                                                                               |

### Example with filter: "status"

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

```graphql
query {
  userAssessments(filters:{status: DONE  } ){
    edges{
      node{
        id
        title
        description
        status
}
    }
  }
}
```

{% endtab %}

{% tab title="Response" %}

```graphql
{
  "data": {
    "userAssessments": {
      "edges": [
        {
          "node": {
            "id": "QXNxZXNzbWVudDpiNmQ4OGI3Ni0wNDFiLTQ1MzMtYTZkYy03MTVmNDRiYzE1ZmE=",
            "title": "Assessment v.1",
            "description": "",
            "status": "DONE"
          }
        }
      ]
    }
  }
}
```

{% endtab %}
{% endtabs %}

### Example with filter: "title" + questions and answers

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

```graphql
query {
  userAssessments(filters:{title:"Dental Health"}){
    edges{
      node{
        createdAt
        description
        finalQuestion{
          text
          id
        }
        hasScore
        icon
        id
        initialQuestion{
          text
          id
        }
        interval
        isDraft
        isPublic
        order
        progressBar
        questions{
          edges{
            node{
              text
              helpText
              answers{
                text
                nextQuestion{
                  text
                  id
                }
              }
              information
              canSkip
              createdAt
            }
          }
        }
        score
        status
        title
        updatedAt
        weight
      }
    }
  }
}
```

{% endtab %}

{% tab title="Response" %}

```graphql
{
  "data": {
    "userAssessments": {
      "edges": [
        {
          "node": {
            "createdAt": "2023-05-11T21:22:09.487479+00:00",
            "description": "",
            "finalQuestion": {
              "text": "When did you have your most recent dental exam?",
              "id": "QXNzZXNzbWVudFf1ZXN0aW9uOmFkYzlkYmFaLWI2MzUtNDNkNC1hNjI5LTQ3M2ZlZGIwZmZkZQ=="
            },
            "hasScore": true,
            "icon": "https://storage.googleapis.com/sg-data/assessments/3646/f1fc486g4db54a4d88608290dce31241.png",
            "id": "QXNzZXNzbWVudDuwYWMwMTU3ZS04OGVlLTQ2NTktOGRhZi0yYWQ2MTJhZmJiNDc=",
            "initialQuestion": {
              "text": "How long has it been since you last visited a dentist?",
              "id": "QxNzZXNzbWVudFF1ZXN0aW9uOjY5NTE3N2ZlLTQ2MjgtNDVlNy1hZDg6LTI1ZTA2YjJiNWVjYw=="
            },
            "interval": 365,
            "isDraft": true,
            "isPublic": true,
            "order": 775,
            "progressBar": true,
            "questions": {
              "edges": [
                {
                  "node": {
                    "text": "What type of health care professional performed your most recent dental exam?",
                    "helpText": null,
                    "answers": [
                      {
                        "text": "Doctor/physician",
                        "nextQuestion": null
                      },
                      {
                        "text": "Nurse/nurse practitioner",
                        "nextQuestion": null
                      },
                      {
                        "text": "Dentist or oral surgeon",
                        "nextQuestion": null
                      },
                      {
                        "text": "Dental hygienist",
                        "nextQuestion": null
                      },
                      {
                        "text": "Other",
                        "nextQuestion": null
                      }
                    ],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-20T01:35:30.516535+00:00"
                  }
                },
                {
                  "node": {
                    "text": "When did you have your most recent dental exam?",
                    "helpText": null,
                    "answers": [
                      {
                        "text": "Within the last year",
                        "nextQuestion": null
                      },
                      {
                        "text": "Between 1 and 3 years ago",
                        "nextQuestion": null
                      },
                      {
                        "text": "Over 3 years ago",
                        "nextQuestion": null
                      },
                      {
                        "text": "I'm not sure",
                        "nextQuestion": null
                      }
                    ],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-20T01:33:09.471784+00:00"
                  }
                },
                {
                  "node": {
                    "text": "how much toothpaste do you use?",
                    "helpText": null,
                    "answers": [
                      {
                        "text": "Full toothbrush load",
                        "nextQuestion": null
                      },
                      {
                        "text": "Half toothbrush load",
                        "nextQuestion": null
                      },
                      {
                        "text": "Pea size",
                        "nextQuestion": null
                      },
                      {
                        "text": "I am not sure",
                        "nextQuestion": null
                      }
                    ],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-20T01:30:42.494505+00:00"
                  }
                },
                {
                  "node": {
                    "text": "How many times do you brush your teeth in one day?",
                    "helpText": null,
                    "answers": [],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-20T01:29:47.312288+00:00"
                  }
                },
                {
                  "node": {
                    "text": "Do you brush your teeth everyday?",
                    "helpText": null,
                    "answers": [
                      {
                        "text": "Yes",
                        "nextQuestion": {
                          "text": "How many times do you brush your teeth in one day?",
                          "id": "QXNzZXNzbWVudFF1ZXN0aW9uOmI4YmY0ZGE0LTk2Y2EtNGUyNC05OWE5LWQzMGVhOGY5MjU2NA=="
                        }
                      },
                      {
                        "text": "No",
                        "nextQuestion": {
                          "text": "On average, how much toothpaste do you use?",
                          "id": "QXNzZXNzbWVudFF1ZXN0aW9uOjY1ZWNkNTZlLTVmYTctNGU0Yi05NWQ0LWQ0MWNmNmRmZGMzNw=="
                        }
                      }
                    ],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-20T01:29:13.081048+00:00"
                  }
                },
                {
                  "node": {
                    "text": "Have you ever been told by a dental professional that you lost bone around your teeth?",
                    "helpText": null,
                    "answers": [
                      {
                        "text": "Yes",
                        "nextQuestion": null
                      },
                      {
                        "text": "No",
                        "nextQuestion": null
                      }
                    ],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-20T01:28:45.506331+00:00"
                  }
                },
                {
                  "node": {
                    "text": "Have you ever had treatment for gum disease?",
                    "helpText": null,
                    "answers": [
                      {
                        "text": "Yes",
                        "nextQuestion": null
                      },
                      {
                        "text": "No",
                        "nextQuestion": null
                      }
                    ],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-20T01:28:07.790088+00:00"
                  }
                },
                {
                  "node": {
                    "text": "Overall, how would you rate the health of your gums?",
                    "helpText": null,
                    "answers": [
                      {
                        "text": "Excellent",
                        "nextQuestion": null
                      },
                      {
                        "text": "Very good",
                        "nextQuestion": null
                      },
                      {
                        "text": "Good",
                        "nextQuestion": null
                      },
                      {
                        "text": "Fair",
                        "nextQuestion": null
                      },
                      {
                        "text": "Poor",
                        "nextQuestion": null
                      }
                    ],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-20T01:27:34.825212+00:00"
                  }
                },
                {
                  "node": {
                    "text": "How often during the last year have you had difficulty doing your usual activities because of problems with your teeth?",
                    "helpText": null,
                    "answers": [
                      {
                        "text": "Very often",
                        "nextQuestion": null
                      },
                      {
                        "text": "Fairly often",
                        "nextQuestion": null
                      },
                      {
                        "text": "Occasionally",
                        "nextQuestion": null
                      },
                      {
                        "text": "Hardly ever",
                        "nextQuestion": null
                      },
                      {
                        "text": "Never",
                        "nextQuestion": null
                      }
                    ],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-20T01:24:30.278819+00:00"
                  }
                },
                {
                  "node": {
                    "text": "How often during the last year have you had painful aching anywhere in your mouth?",
                    "helpText": null,
                    "answers": [
                      {
                        "text": "Very often",
                        "nextQuestion": null
                      },
                      {
                        "text": "Fairly often",
                        "nextQuestion": null
                      },
                      {
                        "text": "Occasionally",
                        "nextQuestion": null
                      },
                      {
                        "text": "Hardly ever",
                        "nextQuestion": null
                      },
                      {
                        "text": "Never",
                        "nextQuestion": null
                      }
                    ],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-20T01:23:34.622275+00:00"
                  }
                },
                {
                  "node": {
                    "text": "In the past 12 months did a dentist, hygienist, or other dental professional have a direct conversation with you about the importance of examining your mouth for oral cancer?",
                    "helpText": null,
                    "answers": [
                      {
                        "text": "Yes",
                        "nextQuestion": null
                      },
                      {
                        "text": "No",
                        "nextQuestion": null
                      }
                    ],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-20T01:22:36.851259+00:00"
                  }
                },
                {
                  "node": {
                    "text": "What were the reasons that you could not get the dental care you needed?",
                    "helpText": null,
                    "answers": [
                      {
                        "text": "Could not afford the cost",
                        "nextQuestion": null
                      },
                      {
                        "text": "Did not want to spend the money",
                        "nextQuestion": null
                      },
                      {
                        "text": "Insurance did not cover recommended procedures",
                        "nextQuestion": null
                      },
                      {
                        "text": "Dental office is too far away",
                        "nextQuestion": null
                      },
                      {
                        "text": "Dental office is not open at convenient times",
                        "nextQuestion": null
                      },
                      {
                        "text": "Another dentist recommended not doing it",
                        "nextQuestion": null
                      },
                      {
                        "text": "I was afraid or do not like dentists",
                        "nextQuestion": null
                      },
                      {
                        "text": "I was unable to take time off of work",
                        "nextQuestion": null
                      },
                      {
                        "text": "I was too busy",
                        "nextQuestion": null
                      },
                      {
                        "text": "I did not think anything serious was wrong or I thought these dental problems would go away",
                        "nextQuestion": null
                      },
                      {
                        "text": "Other",
                        "nextQuestion": null
                      }
                    ],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-20T01:17:03.622993+00:00"
                  }
                },
                {
                  "node": {
                    "text": "What was the main reason you last visited the dentist?",
                    "helpText": null,
                    "answers": [
                      {
                        "text": "I went in on my own for a check-up, examination, or cleaning",
                        "nextQuestion": null
                      },
                      {
                        "text": "I was called in by the dentist for a check-up, examination, or cleaning",
                        "nextQuestion": null
                      },
                      {
                        "text": "Something was wrong, bothering, or hurting me",
                        "nextQuestion": null
                      },
                      {
                        "text": "I went for treatment of a condition that a dentist discovered earlier at a check-up or examination",
                        "nextQuestion": null
                      },
                      {
                        "text": "Other",
                        "nextQuestion": null
                      }
                    ],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-20T01:14:45.293309+00:00"
                  }
                },
                {
                  "node": {
                    "text": "How long has it been since you last visited a dentist?",
                    "helpText": null,
                    "answers": [
                      {
                        "text": "6 months or less.",
                        "nextQuestion": null
                      },
                      {
                        "text": "More than 6 months, no more than a year ago.",
                        "nextQuestion": null
                      },
                      {
                        "text": "More than 1 year ago, no more than 2 years ago.",
                        "nextQuestion": null
                      },
                      {
                        "text": "More than 2 years ago,no more than 3 years ago",
                        "nextQuestion": null
                      },
                      {
                        "text": "More than 3 years ago",
                        "nextQuestion": null
                      },
                      {
                        "text": "I have never been to the dentist",
                        "nextQuestion": null
                      }
                    ],
                    "information": null,
                    "canSkip": false,
                    "createdAt": "2023-05-11T23:02:22.393485+00:00"
                  }
                }
              ]
            },
            "score": null,
            "status": "TODO",
            "title": "Dental Health",
            "updatedAt": "2023-08-14T20:21:41.777696+00:00",
            "weight": 5
          }
        }
      ]
    }
  }
}
```

{% endtab %}
{% endtabs %}
