---
name: "forms_get_response"
area: "forms"
title: "Get a response"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/forms_get_response"
mcp_server: "https://api.conecto.chat/mcp/forms"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/forms/forms_get_response"
---

# Get a response (`forms_get_response`)

One response by its response_id, with every answer readable.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

One person's answers matter: an application to review, a complaint to follow up.

## Say this to your agent

> Open the ride club sign-up from Marcus Webb.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `response_id` | string | yes | 32 to 36 characters. |  |  |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `forms_get_response` on the MCP server `https://api.conecto.chat/mcp/forms` with these arguments:

```json
{
  "response_id": "5be644f8-5b32-4c43-9134-cf68bb2c948a"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/forms_get_response \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"response_id": "5be644f8-5b32-4c43-9134-cf68bb2c948a"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "forms_get_response",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "response": {
      "response_id": "5be644f8-5b32-4c43-9134-cf68bb2c948a",
      "submitted_at": "2026-10-14T08:00:00+00:00",
      "answers": [
        {
          "field_id": "full_name",
          "question": "Your name",
          "type": "short_text",
          "value": "Marcus Webb",
          "answer": "Marcus Webb"
        },
        {
          "field_id": "email",
          "question": "Email",
          "type": "email",
          "value": "marcus.webb@example.com",
          "answer": "marcus.webb@example.com"
        }
      ],
      "hidden": {},
      "contact_id": 4101,
      "form_id": "51414dab-4209-457e-95d1-524478971f37",
      "form_title": "Join the ride club",
      "user_agent": null
    }
  }
}
```

`result`: The response with its form, time, answers (question, stored value, readable answer), link values and CRM contact.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_found` | 404 | No response of the business has that response_id. | Find it with forms_list_responses and use its response_id. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [forms_create](https://conecto.chat/tools/forms/forms_create.md): Creates a form or survey with its own public page that anyone can open and answer. $0.01 a call.
- [forms_update](https://conecto.chat/tools/forms/forms_update.md): Changes a form's fields or settings; only what you pass changes. $0.01 a call.
- [forms_get](https://conecto.chat/tools/forms/forms_get.md): One form with its fields, settings, public link, whether it takes responses (and why not) and its response count. Free up to 1,000,000 reads a month.
- [forms_list](https://conecto.chat/tools/forms/forms_list.md): The business's forms, newest first, with their links, whether each takes responses, and their response counts. Free up to 1,000,000 reads a month.
- [forms_list_responses](https://conecto.chat/tools/forms/forms_list_responses.md): A form's responses, newest first, each answer with its question and a readable value. Free up to 1,000,000 reads a month.
- [forms_summary](https://conecto.chat/tools/forms/forms_summary.md): A form's results at a glance: choice counts, rating averages, the NPS score, yes and no shares, numbers and the latest text answers. Free up to 1,000,000 reads a month.
- [forms_export_responses](https://conecto.chat/tools/forms/forms_export_responses.md): Saves a CSV of a form's responses in the file store and returns a download link. $0.001 a call.
- [forms_close](https://conecto.chat/tools/forms/forms_close.md): Stops a form taking responses; its page then says it is closed. $0.001 a call.
- [forms_open](https://conecto.chat/tools/forms/forms_open.md): Lets a closed form take responses again. $0.001 a call.
- [forms_delete](https://conecto.chat/tools/forms/forms_delete.md): Deletes a form and all its responses for good; its link stops working. $0.001 a call.
- [forms_delete_response](https://conecto.chat/tools/forms/forms_delete_response.md): Deletes one response for good, for a person who asks to be forgotten, or for spam. Free.