Get Submission

Retrieves a single submission by its ID.


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",
  "fields": {
    "name": "Alex",
    "email": "alex@example.com",
    "message": "Hello there"
  },
  "isSpam": false,
  "spamScore": 0,
  "spamSignals": [],
  "submittedAt": "2025-03-15T14:30:00.000Z",
  "ip": "203.0.113.42",
  "userAgent": "Mozilla/5.0 ..."
}

Response fields

Field	Type	Description
`id`	string	Submission ID
`formId`	string	Parent form ID
`fields`	object	Submitted field key-value pairs
`isSpam`	boolean	Whether TorchWarden flagged this as spam
`spamScore`	integer	TorchWarden spam score
`spamSignals`	array	Spam signals that fired on this submission
`submittedAt`	string	ISO 8601 submission timestamp
`ip`	string	Submitter IP address
`userAgent`	string	Submitter user agent

Error responses

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