> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voxworks.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Responses and Export

> Browse individual survey responses, open a response to see its answers, call record and session variables, and download the filtered answers as a CSV — with the file's columns and the permissions that apply.

## Responses

The **Responses** tab in [Results](/surveys/results) mode lists every session that matches the Results filters.

| Column         | Shows                                                                                                                    |
| -------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Respondent** | Who the session belongs to — the respondent key, or the first eight characters of the session id when the key is hidden. |
| **Status**     | The session status — completed, screened out, terminated, and so on.                                                     |
| **Channel**    | Voice.                                                                                                                   |
| **Outcome**    | The outcome code the session ended with.                                                                                 |
| **Started**    | When the interview started.                                                                                              |
| **Duration**   | How long it ran.                                                                                                         |

Test sessions carry a **Test** badge, and appear only when **Include test sessions** is on.

Calls that ended at the gatekeeper — voicemail, no answer, declined or callback at the greeting — are not sessions and do not appear here. See the **Contact funnel** on the Overview tab.

***

## A single response

Click a row to open the response. **All responses** takes you back to the list.

The header shows the session's status, its outcome code, and a **Test** badge for test sessions. A line underneath says either *"test session — excluded from results by default"* or *"live data, not a test session"*.

### The call

Click **Open call record** to slide the session's call record — with its recording and transcript — over the page without leaving the survey. If the call has since been removed, it reads *"This call record is no longer available."* See [Call Details](/calls/call-details).

### Answers

*"In presented order · normalized values"* — each answer in the order the questions were asked, showing the recorded value, plus:

| Tag           | Meaning                                                                                      |
| ------------- | -------------------------------------------------------------------------------------------- |
| *occ (key)*   | The occurrence — `default` for an ordinary question, or the item key for a battery item.     |
| *conf (0.00)* | How confident the recogniser was in what it heard, from 0 to 1.                              |
| **Not final** | An earlier answer the respondent later corrected. Only final answers are counted in Results. |

With no answers: *"This session stored no answers."*

### Session variables

The details stored with the session, such as `call_status`, `batch_id` and `answers_written` — not the call's custom variables, which are on the call record (see [Survey variables and piping](/surveys/survey-variables)). With nothing stored: *"No variables stored against this session."* The card is marked **Full access** or **Permission-gated**. Without the `surveys.responses.sensitive` permission, the respondent key is hidden: *"The respondent key is hidden — it needs the sensitive responses permission."*

***

## Export

The **Export** tab (also the **Export** button in the Results bar) downloads the answers behind the current filters.

The panel, **Export the filtered cohort**, explains: *"One row per answer, carrying the session status, outcome code, test flag, occurrence key, recognition confidence and finality — so the export can be re-aggregated without trusting these figures."* It shows *(n) sessions · (m) answers* for the current filters.

Click **Download CSV**. The file is named after the survey — `(survey-name)-responses.csv`. Change the **Version**, **Range**, **Status**, **Outcome** or **Include test sessions** filters first to export a different set.

### CSV columns

| Column           | Contains                                                                                                                                                            | Example                |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| `session_id`     | The session's id. One session has one row per answer.                                                                                                               | `8b1c…`                |
| `respondent`     | The respondent key — the contact the call was made to, or the caller's number when there is no contact. Blank without the `surveys.responses.sensitive` permission. | `c2f7…`                |
| `status`         | The session status.                                                                                                                                                 | `completed`            |
| `outcome_code`   | The outcome code the session ended with.                                                                                                                            | `completed`            |
| `is_test`        | Whether the session is a test session — its call ran a version that was not published.                                                                              | `false`                |
| `question_key`   | The question's key.                                                                                                                                                 | `q3`                   |
| `occurrence_key` | `default` for an ordinary question, or the item key for each rated battery item.                                                                                    | `education`            |
| `answer`         | The recorded answer.                                                                                                                                                | `Very satisfied`       |
| `confidence`     | Recognition confidence, 0 to 1, when the answer carries one.                                                                                                        | (blank)                |
| `is_final`       | `true` for the final answer to a question; `false` for an answer later corrected.                                                                                   | `true`                 |
| `answered_at`    | When the answer was recorded.                                                                                                                                       | `2026-09-25T02:14:07Z` |

To count respondents, filter on `is_final` = `true` and count distinct `session_id` values. Calls that ended at the gatekeeper are not in the export, because they have no session.

***

## Permissions

| Permission                    | Owner | Member | What it allows                                                                                           |
| ----------------------------- | ----- | ------ | -------------------------------------------------------------------------------------------------------- |
| `surveys.responses.export`    | ✓     | —      | The **Export** tab and **Download CSV**. Without it: *"You do not have permission to export responses."* |
| `surveys.responses.sensitive` | ✓     | —      | Seeing the respondent key on a response.                                                                 |

See [Surveys](/surveys/overview) for the full permissions list.
