---
title: "Search survey responses"
method: GET
path: "/engagement/surveys/responses/search"
tags: ["Engagement Survey"]
---

# Search survey responses

`GET /engagement/surveys/responses/search`

## Request

- Base URL: `https://api.gleap.io/v3`
- URL: `https://api.gleap.io/v3/engagement/surveys/responses/search`
- Auth: HTTP bearer

Full-text search over the answers of all the project's survey responses (Surveys 2.0), newest first.
Query parameters: `q` (required, 2–100 characters), `surveyId` (optional, narrows to one survey),
`status` (optional comma list of `completed`, `partial`, `in_progress`), `limit` (default 10, at most 50).
Answers `{ available, hits: [{ id, surveyId, surveyName, status, channel, nps, snippet, contact,
createdAt, completedAt }] }`; `available: false` means the search index is not available in this region
(use `GET /{surveyId}/responses?q=` per survey instead).

## Headers

- `project` string, required

## Response `200`

Ok

- unknown

## Changes

- **2026-10-08** `fd83cd1963c4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gleap/apis/gleap-server/changes/engagement/surveys/responses/search/get.md)

---

[API](https://skmtc.dev/gleap/apis/gleap-server.md) - [All operations](https://skmtc.dev/gleap/apis/gleap-server/llms.txt) - [OpenAPI document](https://skmtc.dev/gleap/apis/gleap-server/revisions/3b025e883cef?raw)