Submissions

A submission is one person’s answers to a form. For fields and response details, see the API reference for listing submissions, a single submission, exports and insights. To find a form id, see Forms.

List submissions

This command lists the submissions for one form, oldest first by default (--order desc for newest first), with each answer alongside the question it responds to. Only completed submissions are listed unless you pass --status. Use this when you want to read what people submitted, or to find a submission id.

neetoform forms submissions list 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 --json

neetoform forms submissions list 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 --submitted-after 2026-10-12 --order desc --json

Required arguments:

<form-id> - The form’s UUID, from neetoform forms list

Flag	Type	Default	Description
`--order`	`string`		Sort by submission time: asc (oldest first, default) or desc
`--page`	`int`	`0`	Page number
`--page-size`	`int`	`0`	Items per page (max 100)
`--search`	`string`		Only submissions whose answers match this text
`--status`	`string`		Which submissions to list: completed (default), incomplete or all
`--submitted-after`	`string`		Only submissions at or after this ISO 8601 date (YYYY-MM-DD) or date-time
`--submitted-before`	`string`		Only submissions before this ISO 8601 date (YYYY-MM-DD) or date-time

Sample output (--json)

{
  "data": [
    {
      "id": "f1c0d5e2-8a44-4c17-9d1e-2b6f4a8e37c5",
      "created_at": "2026-02-14T11:05:31.000Z",
      "field_values": [],
      "user_agent": {
        "id": "9d4a1c77-2f65-4a0b-bb31-5e8c0d92a614",
        "name": "Chrome",
        "version": "141.0.0",
        "ip_address": "203.0.113.42",
        "device_name": "Mac",
        "device_type": "desktop",
        "operating_system": "macOS",
        "operating_system_version": "26.5",
        "submission_id": "f1c0d5e2-8a44-4c17-9d1e-2b6f4a8e37c5",
        "created_at": "2026-02-14T11:05:31.000Z",
        "updated_at": "2026-02-14T11:05:31.000Z"
      },
      "responses": [
        {
          "id": "3a9b6c11-5d72-4e88-a0f3-91c47de2b6aa",
          "label": "What is your name?",
          "position": 1,
          "kind": "short_answer",
          "slug": "what-is-your-name",
          "value": "Oliver Smith"
        },
        {
          "id": "6e2d18f4-c093-4b5a-8f77-40a1b9c3de52",
          "label": "How likely are you to recommend us?",
          "position": 2,
          "kind": "linear_scale",
          "slug": "how-likely-are-you-to-recommend-us",
          "value": "9"
        }
      ]
    }
  ],
  "breadcrumbs": [
    {
      "label": "Form",
      "command": "neetoform forms list"
    }
  ],
  "pagination": {
    "current_page_number": 1,
    "total_pages": 1,
    "total_records": 1,
    "page_size": 30
  }
}

--status accepts only completed, incomplete, or all. --search keeps submissions whose answers match the text. Each entry in responses follows the form’s current question order, and kind names the field type the question was built with, which is what decides the shape of value. --submitted-after is inclusive and --submitted-before is exclusive; both take YYYY-MM-DD (midnight UTC) or a full ISO 8601 date-time. A question the person skipped has no entry, so to build columns, key answers by slug and take the column list from neetoform forms show. On a terminal the table gives each question a column of its own, in that same order, alongside id and created_at. field_values and user_agent have no column, so read a submission in full with --verbose:

neetoform forms submissions list 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 --verbose

Show a submission

This command shows one submission, completed or not, with its answers in the form’s question order and its payment status. A question the person skipped has no entry.

neetoform forms submissions show 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 f1c0d5e2-8a44-4c17-9d1e-2b6f4a8e37c5 --json

Required arguments:

<form-id> - The form’s UUID, from neetoform forms list
<submission-id> - The submission’s UUID, from neetoform forms submissions list

Sample output (--json)

{
  "data": {
    "id": "f1c0d5e2-8a44-4c17-9d1e-2b6f4a8e37c5",
    "created_at": "2026-02-14T11:05:31.000Z",
    "is_completed": true,
    "payment_status": null,
    "field_values": [],
    "user_agent": {
      "name": "Chrome",
      "version": "141.0.0",
      "ip_address": "203.0.113.42",
      "device_name": "Mac",
      "device_type": "desktop",
      "operating_system": "macOS",
      "operating_system_version": "26.5"
    },
    "responses": [
      {
        "id": "3a9b6c11-5d72-4e88-a0f3-91c47de2b6aa",
        "label": "What is your name?",
        "position": 1,
        "kind": "short_answer",
        "slug": "what-is-your-name",
        "value": "Oliver Smith"
      }
    ]
  }
}

Delete a submission

This command moves one submission to the trash. You can restore it from the trash in NeetoForm. The command runs at once and does not ask you to confirm.

neetoform forms submissions delete 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 f1c0d5e2-8a44-4c17-9d1e-2b6f4a8e37c5

Required arguments:

<form-id> - The form’s UUID, from neetoform forms list
<submission-id> - The submission’s UUID, from neetoform forms submissions list

Delete many submissions

This command moves several submissions to the trash and prints how many were moved. Ids that do not belong to the form, or are already in the trash, are skipped.

neetoform forms submissions bulk-delete 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 --ids f1c0d5e2-8a44-4c17-9d1e-2b6f4a8e37c5,2c7f4a1e-6a0b-4d7e-9c55-1b3c9f0d8e21

Required arguments:

<form-id> - The form’s UUID, from neetoform forms list

Flag	Type	Required	Default	Description
`--ids`	`string`	Yes		Comma-separated submission IDs to move to the trash

Email the respondents

This command sends an email to the people who made the chosen submissions. Each message goes to the address in the email question you name, and the emails go to real people. They are sent in the background, so the command only confirms that they are queued.

neetoform forms submissions send-responses 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 \
  --ids f1c0d5e2-8a44-4c17-9d1e-2b6f4a8e37c5 \
  --email-question-id 3a9b6c11-5d72-4e88-a0f3-91c47de2b6aa \
  --subject "Thanks for your response" \
  --body "<p>Hi, we got your response.</p>"

Required arguments:

<form-id> - The form’s UUID, from neetoform forms list

Flag	Type	Required	Description
`--bcc-emails`	`string`		Comma-separated BCC addresses
`--body`	`string`	Yes	Email body as HTML
`--cc-emails`	`string`		Comma-separated CC addresses
`--email-question-id`	`string`	Yes	ID of the email question whose answer is the recipient address
`--ids`	`string`	Yes	Comma-separated submission IDs to email, up to 100
`--subject`	`string`	Yes	Email subject

You can email at most 100 submissions in one call. --body is HTML.

Export submissions

This command exports submissions as a CSV, XLSX, or PDF file. The file is not printed. It is made in the background, and a download link is emailed to the recipient. The link works for 15 days, and if no submissions match, no email is sent.

neetoform forms submissions export 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 --type csv --recipient-email oliver@example.com

Required arguments:

<form-id> - The form’s UUID, from neetoform forms list

Flag	Type	Required	Default	Description
`--ids`	`string`			Comma-separated submission IDs to export (default: all completed submissions)
`--include-hidden-fields`	`bool`		`false`	Include hidden fields
`--include-meta-data`	`bool`		`false`	Include submission meta data
`--include-question-descriptions`	`bool`		`false`	Include question descriptions
`--recipient-email`	`string`			Team member email that receives the download link (default: you)
`--type`	`string`	Yes		Export format: csv, xlsx or pdf

--type accepts only csv, xlsx, or pdf. Without --ids, all completed submissions are exported.

Show form insights

This command shows visits, starts, submissions, completion rate, average time to submit, and the split by device, operating system, and browser. It covers all time unless you give a date range.

neetoform forms insights 7db4b04a-6e17-4af6-a1d6-650c4cba3f91 --start-date 2026-10-01 --end-date 2026-10-28 --time-zone Asia/Kolkata --json

Required arguments:

<form-id> - The form’s UUID, from neetoform forms list

Flag	Type	Description
`--end-date`	`string`	Last day to include (YYYY-MM-DD); use with —start-date
`--start-date`	`string`	First day to include (YYYY-MM-DD); use with —end-date
`--time-zone`	`string`	IANA time zone such as Asia/Kolkata (default: your time zone)

Pass --start-date and --end-date together, as YYYY-MM-DD.

Sample output (--json)

{
  "data": {
    "visit_count": 420,
    "start_count": 180,
    "submission_count": 128,
    "completion_rate": 71,
    "average_submission_time": { "h": 0, "m": 2, "s": 14 },
    "devices": { "desktop": 62, "mobile": 36, "tablet": 2 },
    "operating_systems": { "macOS": 40, "Windows": 30, "iOS": 20, "Android": 10 },
    "browsers": { "Chrome": 65, "Safari": 25, "Firefox": 10 }
  }
}

Getting started

Commands

List submissions

Show a submission

Delete a submission

Delete many submissions

Email the respondents

Export submissions

Show form insights

​List submissions

​Show a submission

​Delete a submission

​Delete many submissions

​Email the respondents

​Export submissions

​Show form insights

List submissions

Show a submission

Delete a submission

Delete many submissions

Email the respondents

Export submissions

Show form insights