> 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 — every answer a subscriber gave. No subscriber identity is included.

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

**Example**

```json
{
  "uuid": "ssub_44aa22bb",
  "submitted_at": "2026-06-02T14:20:00.000Z",
  "source": "signup_flow",
  "answers": [
    {
      "value": "Engineer",
      "answered_at": "2026-06-02T14:20:00.000Z",
      "question": {
        "uuid": "sqn_9f8e7d6c",
        "position": 1,
        "label": "What best describes your role?",
        "required": true,
        "type": "single_select",
        "options": ["Founder", "Engineer", "Marketer", "Other"]
      }
    }
  ]
}
```