findResponsesByAssessment()

returns form responses for a specific form submitted within a specific assessment cycle, optionally filtered by date range this is useful when you need to scope responses to a particular review or survey cycle, rather than pulling all responses across all time syntax findresponsesbyassessment(form, assessment\[, from]\[, until]) parameters parameter type description form string docid\ ujw2aqaktel5uuklup73s name or id of the form assessment string docid\ ujw2aqaktel5uuklup73s name or id of the assessment cycle from timestamp docid\ j1ufztc3 yprdi3ucin3u starting point of the date range to traverse (inclusive) until timestamp docid\ j1ufztc3 yprdi3ucin3u ending point of the date range to traverse (exclusive) return type list docid\ xwh cukhj9waqaefb7h71 < formresponse docid\ lihl9i6dr0einbnndg2ec > examples findresponsesbyassessment('manager review', 'q3 2024 performance review') count() counts the total number of manager review submissions within the q3 2024 performance cycle findresponsesbyassessment('manager review', 'q3 2024 performance review') mean{answervalue reviewscore} returns the average review score across all submissions in the specified assessment cycle findresponsesbyassessment('self review', 'q3 2024 performance review') groupby{target} count() in a dashboard, shows how many self reviews were submitted per person in the q3 2024 cycle