---
title: "GET form_responses"
method: GET
path: "/{project_key}/form_responses"
---

# GET form_responses

`GET /{project_key}/form_responses`

Returns responses from CloseAlert that are received.

## Query parameters

- `form_id` integer
- `since` string, date-time
- `until` string, date-time
- `per_page` integer
- `page` integer
- `mailing_id` integer
- `group_id` integer

## Response `200`

successful operation

- object
  - `form_responses` FormResponse[]
    - `id` integer — the id of the form_response
    - `created_at` string, date-time — the time stamp (ISO8601) this form_response was received
    - `email` string — the email address of the recipient
    - `mail_url` string — the mail_url of the recipient
    - `user_agent` string — the user agent of the recipient
    - `followed_up` boolean — whether a follow up mail was send by CloseAlert based on given answers
    - `merge_tags` object — the merge tags that were send by the ESP
    - `form` object — the form this response was received on
      - `id` integer — the id of the form
      - `form_type` string — the type of the form the response was received on
      - `name` string — the name of the form
    - `mailing` object — the mailing this response was received on
      - `id` integer — the id of the mailing
      - `name` string — the name of the mailing
    - `group` object — the group the mailing is in (either direct or nested)
      - `id` integer — the id of the group
      - `name` string — the name of the group
    - `answer` object[] — the given answers of the recipient
      - `question` string — the question that was asked
      - `question_type` string — the type of the question
      - `question_index` integer — The index of the question on received form
      - `response_value` string — The given answer of the recipient on this question
  - `meta` Meta
    - `page` integer — The page number
    - `per_page` integer — Maximum results per page
    - `total_pages` integer — The total number of pages

## Other responses

- `403` — Authentication failed
- `422` — Validation failed
- `429` — Too many requests
- `504` — Took server too long to respond

---

[API](https://skmtc.dev/closealert/apis/closealert-reporting-api.md) · [All operations](https://skmtc.dev/closealert/apis/closealert-reporting-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/closealert/closealert-reporting-api/revisions/4e88890c581c/schema)