---
title: "Aggregated per-question statistics"
method: GET
path: "/responses/stats/aggregated"
tags: ["Analytics"]
---

# Aggregated per-question statistics

`GET /responses/stats/aggregated`

## Request

- Base URL: `https://api.foxform.app`
- URL: `https://api.foxform.app/responses/stats/aggregated`
- Auth: API key in header `x-api-key`

## Query parameters

- `formId` string, required

## Response `200`

Aggregated stats.

- GetAggregatedStatsResponse
  - `success` boolean
  - `data` AggregatedStats
    - `form_id` string
    - `overview` object
      - `total_responses` integer
      - `first_response_at` string, nullable
      - `last_response_at` string, nullable
    - `timeline` object[]
      - `date` string
      - `count` integer
    - `questions` object[]
      - `question_id` string
      - `question_type` 'welcome' | 'loading' | 'result' | 'end' | 'short_text' | 'long_text' | 'dropdown' | 'checkboxes' | 'multiple_choice' | 'email' | 'phone' | 'number' | 'date' | 'rating' | 'opinion_scale' | 'nps' | 'yes_no' | 'file_upload' | 'picture_choice' | 'url' | 'slider' | 'alert' | 'testimonials' | 'media' | 'timer' | 'arguments' | 'price' | 'progress_bar'
      - `question_title` string
      - `data` object: One of choice/boolean/numeric/date/text/file stats.
  - `message` string

---

[API](https://skmtc.dev/foxform/apis/foxform-api.md) · [All operations](https://skmtc.dev/foxform/apis/foxform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/foxform/apis/foxform-api/revisions/fe83b1999541?raw)