Get Submission

Retrieves a single submission by its ID. Returns 404 if the submission is quota-locked or belongs to a different account.


GET /v1/submissions/{submissionId}

Request


curl https://api.formtorch.com/v1/submissions/x9y8z7w6v5 \
  -H "Authorization: Bearer YOUR_API_KEY"

Path parameters

Parameter	Description
`submissionId`	The 10-character submission ID

Response


{
  "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"
}

Response fields

Field	Type	Description
`id`	string	Submission ID
`formId`	string	Parent form ID
`data`	object	Submitted field key-value pairs
`isTest`	boolean	Whether this was a test submission (`_test=true`)
`isSpam`	boolean	Whether TorchWarden flagged this as spam
`isSuspicious`	boolean	Whether TorchWarden flagged this as suspicious
`spamScore`	integer	TorchWarden spam score
`deliveryStatus`	string	Email delivery status (`pending`, `delivered`, `failed`, `skipped`)
`createdAt`	string	ISO 8601 submission timestamp

Error responses

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