---
title: "Get responses"
method: GET
path: "/responses"
tags: ["responses"]
---

# Get responses

`GET /responses`

Gets responses from the database.

## Query parameters

- `surveyId` string, required
- `limit` number
- `skip` number
- `sortBy` 'createdAt' | 'updatedAt'
- `order` 'asc' | 'desc'
- `startDate` string, required
- `endDate` string, required
- `contactId` string, required

## Response `200`

Responses retrieved successfully.

- Response[]
  - `id` string, required — The ID of the response
  - `createdAt` string, required — The date and time the response was created
  - `updatedAt` string, required — The date and time the response was last updated
  - `finished` boolean, required — Whether the response is finished
  - `surveyId` string, required — The ID of the survey
  - `contactId` string, nullable, required — The ID of the contact
  - `endingId` string, nullable, required — The ID of the ending
  - `data` object, required — The data of the response
  - `variables` object, required — The variables of the response
  - `ttc` object, required — The TTC of the response
  - `meta` object, required — The meta data of the response
    - `source` string — The source of the response
    - `url` string — The URL of the response
    - `userAgent` object
      - `browser` string
      - `os` string
      - `device` string
    - `country` string
    - `action` string
  - `contactAttributes` object, nullable, required — The attributes of the contact
  - `singleUseId` string, nullable, required — The single use ID of the response
  - `language` string, nullable, required — The language of the response
  - `displayId` string, nullable, required — The display ID of the response

---

[API](https://skmtc.net/formbricks/apis/formbricks-api.md) · [All operations](https://skmtc.net/formbricks/apis/formbricks-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/formbricks/formbricks-api/versions/bcd488e71451/schema)