---
title: findResponses()
slug: findresponses
docTags: 
createdAt: 2021-09-14T16:33:14.000Z
---

Returns form responses for a particular form submitted over a period of time.

### Syntax

`findResponses(form[, from][, until])`

### Parameters

| **Parameter** | **Type**                                   | **Description**                                          |
| ------------- | ------------------------------------------ | -------------------------------------------------------- |
| `form`        | [String](docId\:Ujw2AQAktel5uukLuP73S)     | Name or ID of the form                                   |
| `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

`findResponses('1:1 Form', '-30d').count()`

Returns the number of form responses that have been submitted in the past 30 days.

`findResponses('Manager Review', '2024-01-01', '2025-01-01').mean{answerValue.reviewScore}`

Returns the average review score of all submissions of the `Manager Review` form submitted in calendar year 2024.

`findResponses('Shoutout', intervalFrom, intervalUntil).groupBy{submitPerson}.count()`&#x20;

In a Dashboard, return the top submitters of the `Shoutout` form.

`findResponses('Shoutout', intervalFrom, intervalUntil).groupBy{target}.count()`&#x20;

In a Dashboard, return the top recipients of the `Shoutout` form.