SoftSolzSoftSolz
Sign up
HomeAPI GuideAPI ReferenceWidget Tester
forms

List submissions for a form. Filter by answer with f[field][operator]=value (equals, contains, is_empty, is_not_empty, gt, lt).

List submissions for a form. Filter by answer with f[field][operator]=value (equals, contains, is_empty, is_not_empty, gt, lt).

GEThttps://app.softsolz.uk/api/v1/services/forms/forms/{id}/submissions

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Query Params

searchstring

Substring match against submission data.

statusstring

Only this status: new, in_progress or completed.

archivedstring

false, true or all (default all).

sourcestring

Only this source: widget, link, api or direct.

assigned_tostring

Member id, "me" (the key owner) or "none".

date_fromstring

Only submissions created at or after this ISO date or timestamp.

date_tostring

Only submissions created at or before this ISO timestamp. A bare YYYY-MM-DD includes that whole day.

sortstring

created_at_desc (default) or created_at_asc.

unread_onlyboolean

When "true", return only unread submissions.

limitinteger

Page size, 1-200 (default 50).

offsetinteger

Pagination offset (default 0).

Response

Response Body · array of objects

idintegerSubmission id.
form_idintegerParent form id.
dataobjectSubmitted values keyed by field id. File fields carry { filename, mime, size_bytes }.
source_kindstringHow the submission arrived (api, widget, direct).
read_atstring | nullWhen marked read; null if unread.
created_atstringSubmission timestamp.
statusstringTriage status.
archived_atstring | nullWhen archived; null when not archived.
assigned_tointeger | nullMember the submission is assigned to.
payment_statusstring | nullPayment state when the form takes a payment (pending, paid, failed, expired).
duration_msinteger | nullTime the respondent spent filling the form, when known.
form_version_idinteger | nullPublished version of the form that collected the answers.
contact_idstring | nullLinked contact, when one was matched.

Request

curl --request GET \
  --url https://app.softsolz.uk/api/v1/services/forms/forms/{id}/submissions \
  --header 'Authorization: Bearer sk_live_your_key'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
  "data": [
    {
      "id": 1001,
      "form_id": 42,
      "data": {
        "full_name": "Jane Doe",
        "email": "jane@example.com"
      },
      "source_kind": "api",
      "read_at": null,
      "created_at": "2026-06-04T18:11:00.000Z",
      "status": "new",
      "archived_at": null,
      "assigned_to": null,
      "payment_status": null,
      "duration_ms": 48000,
      "form_version_id": 7,
      "contact_id": null
    }
  ],
  "meta": {
    "limit": 50,
    "offset": 0,
    "total": 1,
    "has_more": false
  }
}