---
title: findResponsesByAssessment()
slug: findresponsesbyassessment
docTags: 
createdAt: 2026-04-28T17:54:09.355Z
---

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.