List Submissions

Returns submissions for a form, ordered by most recent first.


GET /v1/forms/{formId}/submissions

Request


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

Path parameters

Parameter	Description
`formId`	The 10-character form ID

Query parameters

Parameter	Type	Default	Description
`limit`	integer	20	Results per page (max: 100)
`cursor`	string	none	Pagination cursor from previous response
`spam`	boolean	`false`	Include spam submissions
`since`	string	none	ISO 8601 timestamp. Returns only submissions after this time.

Response


{
  "submissions": [
    {
      "id": "x9y8z7w6v5",
      "formId": "a1b2c3d4e5",
      "fields": {
        "name": "Alex",
        "email": "alex@example.com",
        "message": "Hello there"
      },
      "isSpam": false,
      "spamScore": 0,
      "submittedAt": "2025-03-15T14:30:00.000Z",
      "ip": "203.0.113.42",
      "userAgent": "Mozilla/5.0 ..."
    }
  ],
  "nextCursor": "eyJpZCI6Ing5eThaN3c2djUifQ"
}

Response fields

Field	Type	Description
`submissions`	array	List of submission objects
`submissions[].id`	string	Submission ID
`submissions[].formId`	string	Parent form ID
`submissions[].fields`	object	Submitted field key-value pairs
`submissions[].isSpam`	boolean	Whether TorchWarden flagged this as spam
`submissions[].spamScore`	integer	TorchWarden spam score
`submissions[].submittedAt`	string	ISO 8601 submission timestamp
`submissions[].ip`	string	Submitter IP address
`submissions[].userAgent`	string	Submitter user agent
`nextCursor`	string or null	Pass to `cursor` for the next page