---
title: "Return privacy-safe findings and chart-ready data."
method: GET
path: "/v1/responses/analyze"
---

# Return privacy-safe findings and chart-ready data.

`GET /v1/responses/analyze`

## Request

- Base URL: `http://127.0.0.1:8080`
- URL: `http://127.0.0.1:8080/v1/responses/analyze`
- Auth: HTTP bearer

Uses the same privacy and bounded-snapshot policy as responses_aggregate, adding descriptive findings and bar-chart data. Findings are observational and do not claim causality.

## Query parameters

- `collectionId` string, uuid
- `acceptedFrom` string, date-time
- `acceptedTo` string, date-time
- `minimumGroupSize` integer

## Headers

- `X-Likerts-Workspace` string

## Response `200`

Success

- ResponseAnalysis
  - `generatedAt` string, date-time, required
  - `responseCount` integer, required
  - `collectionCount` integer, required
  - `privacy` AnalysisPrivacy, required
    - `minimumGroupSize` integer, required
    - `smallCellsSuppressed` unknown, required
    - `textAnswersIncluded` unknown, required
    - `respondentMetadataIncluded` unknown, required
    - `note` string, required
  - `collections` object[], required
  - `findings` object[], required
  - `visualizations` object[], required

## Other responses

- `400`: Invalid filters or the bounded analysis limit was exceeded.
- `401`: Missing or invalid credential.
- `403`: The credential lacks responses:read.
- `500`: Internal service error.

---

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