> For the complete documentation index, see [llms.txt](https://docs.sparkloop.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sparkloop.app/api-v3/objects-schema/survey-submission-object.md).

# Survey Submission Object

## Survey Submission Object

One completed survey submission — the subscriber's email and every answer they gave.

| Field          | Type   | Description                                                                                                          |
| -------------- | ------ | -------------------------------------------------------------------------------------------------------------------- |
| `uuid`         | String | Submission UUID.                                                                                                     |
| `email`        | String | The email address of the subscriber who submitted it.                                                                |
| `submitted_at` | String | When the submission was completed (ISO 8601).                                                                        |
| `source`       | String | Where it came from: `signup_flow`, `recommendations_hub`, `api`, or `client_api`.                                    |
| `answers`      | Array  | The submitted answers, ordered by question position. Each is a **Survey Answer Object** with its `question` inlined. |

**Example**

```json
{
  "uuid": "survey_submission_44aa22bb7c05",
  "email": "jane@example.com",
  "submitted_at": "2026-06-02T14:20:00Z",
  "source": "signup_flow",
  "answers": [
    {
      "value": "Engineer",
      "answered_at": "2026-06-02T14:20:00Z",
      "question": {
        "uuid": "survey_question_9f8e7d6c1a2b",
        "position": 1,
        "label": "What best describes your role?",
        "required": true,
        "type": "single_select",
        "options": [
          { "id": "opt_1a2b3c4d5e6f", "label": "Founder" },
          { "id": "opt_2b3c4d5e6f7a", "label": "Engineer" },
          { "id": "opt_3c4d5e6f7a8b", "label": "Marketer" },
          { "id": "opt_4d5e6f7a8b9c", "label": "Other" }
        ]
      }
    }
  ]
}
```
