List Submissions

Returns submissions for a form, ordered by most recent first by default. Quota-locked submissions are excluded.


GET /v1/forms/{formId}/submissions

Request


curl "https://api.formtorch.com/v1/forms/a1b2c3d4e5/submissions?limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

Path parameters

Parameter	Description
`formId`	The 10-character form ID

Query parameters

Parameter	Type	Default	Description
`limit`	integer	25	Results per page (max: 100 Starter, 250 Pro)
`cursor`	string	none	Pagination cursor from previous response
`order`	string	`desc`	Sort direction: `desc` (newest first) or `asc` (oldest first)

Response


{
  "data": [
    {
      "id": "x9y8z7w6v5",
      "formId": "a1b2c3d4e5",
      "data": {
        "name": "Alex",
        "email": "alex@example.com",
        "message": "Hello there"
      },
      "isTest": false,
      "isSpam": false,
      "isSuspicious": false,
      "spamScore": 0,
      "deliveryStatus": "delivered",
      "createdAt": "2025-03-15T14:30:00.000Z"
    }
  ],
  "next_cursor": "eyJjcmVhdGVkQXQiOiIyMDI1LTAzLTE1VDE0OjMwOjAwLjAwMFoiLCJpZCI6Ing5eThaN3c2djUifQ",
  "has_more": false
}

Response fields

Field	Type	Description
`data`	array	List of submission objects
`data[].id`	string	Submission ID
`data[].formId`	string	Parent form ID
`data[].data`	object	Submitted field key-value pairs
`data[].isTest`	boolean	Whether this was a test submission (`_test=true`)
`data[].isSpam`	boolean	Whether TorchWarden flagged this as spam
`data[].isSuspicious`	boolean	Whether TorchWarden flagged this as suspicious
`data[].spamScore`	integer	TorchWarden spam score
`data[].deliveryStatus`	string	Email delivery status (`pending`, `delivered`, `failed`, `skipped`)
`data[].createdAt`	string	ISO 8601 submission timestamp
`next_cursor`	string or null	Pass as `cursor` to fetch the next page
`has_more`	boolean	Whether more results exist beyond this page

Error responses

Status	Code	Description
`404`	`not_found`	No form with this ID in your account