# 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 %} --- # 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/assessments/user-assessments.md?ask= ``` 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.