---
title: "Count responses and selected form options"
method: GET
path: "/v1/sites/{site_id}/widgets/{widget_id}/responses/summary"
tags: ["Responses"]
---

# Count responses and selected form options

`GET /v1/sites/{site_id}/widgets/{widget_id}/responses/summary`

## Request

- Base URL: `https://api.getsitecontrol.com`
- URL: `https://api.getsitecontrol.com/v1/sites/{site_id}/widgets/{widget_id}/responses/summary`
- Auth: HTTP bearer

Exact counts of all stored form responses of one widget, including deleted widgets, optionally filtered by send time. Use this to count responses with a selected checkbox or other form option, rather than counting a page of list_widget_responses yourself. No sampling or page limit. total counts responses, fields[].count counts those with that field, and options[].count counts those selecting that option. Checkbox option counts can overlap. Missing flags are not counted as false. Fields and options follow the widget's current form; removed fields and options are omitted. Free-text answers are not returned. These are stored responses, not submission event counters; delayed confirmation and deleted responses can change them.

## Path parameters

- `site_id` integer, required
- `widget_id` integer, required: Widget id from `list_widgets`

## Query parameters

- `created_since` string, date-time: Sent at or after this moment; without an offset, taken as UTC; a plain date means its start
- `created_before` string, date-time: Sent before this moment; without an offset, taken as UTC; a plain date means its start

## Response `200`

Successful Response

- WidgetResponsesSummary
  - `total` integer, required: All stored responses in the requested period
  - `fields` ResponseFieldCounts[], required
    - `name` string, required
    - `type` string, required
    - `label` string, nullable
    - `count` integer, required: Responses containing this field
    - `options` ResponseOptionCount[], required
      - `value` union, required
        - boolean
        - string
      - `label` string, nullable
      - `count` integer, required
  - `warnings` string[], required

## Other responses

- `400`: Unsupported GSC-Version
- `401`: Missing or invalid API key or access token
- `403`: Access denied
- `404`: `widget_not_found`: no widget of this site
- `422`: `validation_failed`: a malformed parameter, or `created_since` after `created_before`.
- `429`: `rate_limited`: the key, account or heavy bucket is spent; this operation spends the heavy bucket shared with statistics and other heavy calls
- `503`: Temporarily unavailable; retry later

---

[API](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api.md) - [All operations](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api/revisions/084fcad80e75?raw)