---
title: "Get form results"
method: GET
path: "/forms/{formId}/results"
tags: ["Analytics"]
---

# Get form results

`GET /forms/{formId}/results`

## Request

- Base URL: `https://api.clipform.io/v1`
- URL: `https://api.clipform.io/v1/forms/{formId}/results`
- Auth: HTTP bearer

Returns aggregated results for a form.

## Path parameters

- `formId` string, uuid, required

## Response `200`

Aggregated results

- object
  - `total_responses` integer
  - `public_results_allowed` boolean: Whether this workspace may enable the public results portal, server-computed from the rollout flag and allowlist.
  - `results_url` string, uri: Dashboard Responses tab for this form. Absent for an anonymous caller.
  - `nodes` object[]
    - `node_id` string
    - `node_text` string
    - `node_type` string
    - `total_responses` integer
    - `total_views` integer
    - `answers` object[]
  - `flow` object
    - `nodes` object[]
    - `links` object[]

## Other responses

- `429`: Rate limit exceeded.

---

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