List submissions for a form

GET

https://ssuccessv2.com/app/api/v1/forms/submissions/:id

GET

/app/api/v1/forms/submissions/:id

$ curl -G https://ssuccessv2.com/app/api/v1/forms/submissions/42 \
>      -H "Authorization: Bearer <token>" \
>      -d page=1 \
>      -d per_page=10 \
>      -d search=Ava \
>      -d sort_by=submitted_at \
>      -d sort_dir=DESC \
>      -d spam=false \
>      -d imported=no

1 {
2   "status": "success",
3   "message": "",
4   "data": {
5     "form": {
6       "id": 42,
7       "name": "Emergency Contact Form"
8     },
9     "submissions": {
10       "current_page": 1,
11       "data": [
12         {
13           "id": 901,
14           "form_data": {
15             "student_name": "Ava Lee"
16           },
17           "reference_hash": null,
18           "created_at": "August 20",
19           "2026 10:15 AM": null,
20           "is_spam": false,
21           "imported": false,
22           "payment_id": null,
23           "payment_recurring_id": null,
24           "submitter_name": "Ava Lee",
25           "completed_documents": [],
26           "payment": null,
27           "payer": null,
28           "workflow_current_stage": null
29         }
30       ],
31       "from": 1,
32       "last_page": 1,
33       "per_page": 10,
34       "to": 1,
35       "total": 1,
36       "links": [],
37       "path": "https://localssuccessv2.local/api/v1/forms/submissions/42"
38     }
39   }
40 }

Returns the form payload and its submissions using the legacy form-submissions listing contract. Results are paginated and can be searched, filtered, and sorted with the supported query parameters.

Authentication

AuthorizationBearer

The signed-in SchoolSet user token sent by the frontend.

Path parameters

idlongRequired>=1

Form ID whose submissions are requested.

Query parameters

pageintegerOptional>=1Defaults to 1

Page number (default 1).

per_pageintegerOptional>=1Defaults to 10

Number of records per page (default 10).

searchstringOptional

Case-insensitive search over form data

sort_bystringOptionalDefaults to submitted_at

Sort key; submitted_at and created_at sort by creation time.

sort_direnumOptionalDefaults to DESC

Sort direction.

Allowed values:

spambooleanOptionalDefaults to false

Boolean spam filter (default false).

importedenumOptional

Filter by imported state.

Allowed values:

Response

Form submissions and pagination metadata.

statusenum

messagestring

dataobject

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error