Form Submissions API

Fetch form submission data using the FormSync Public API.

Get Form Submissions

Fetch all submissions for a specific form.

This endpoint returns only user-submitted data, without any internal metadata.

Endpoint

http
1GET [BASE_URL]/forms/{formId}/submissions

Path Parameters

Parameter	Type	Required	Description
`formId`	`string`	`true`	The public Form ID. Example: `fSxYzAbC1234`

Example Request

bash
1curl https://api.formsync.app/public/v1/forms/FORM_ID/submissions \
2  -H "Authorization: Bearer fs_your_api_key"

Successful Response

json
1{
2  "success": true,
3  "submissions": [
4    {
5      "data": {
6        "name": "John Doe",
7        "email": "john@example.com",
8        "message": "Hello, this is a test submission.",
9        "_redirect": "https://example.com/thank-you",
10      },
11      "createdAt": "2026-01-16T12:09:44.740Z"
12    }
13  ]
14}

Response Schema

Field	Type	Description
`success`	`boolean`	Indicates if the request was successful.
`submissions`	`array`	A list of submission objects.
`submissions[].data`	`object`	The user-submitted data.
`submissions[].createdAt`	`string`	The ISO timestamp of the submission.

Response Details

Only the data object is returned
Internal fields are removed
Results are sorted by latest submission first

Usage Example (JavaScript)

ts
1fetch("https://api.formsync.app/public/v1/forms/FORM_ID/submissions", {
2    headers: {
3        Authorization: `Bearer ${process.env.FORMSYNC_API_KEY}`,
4    },
5}).then(res => res.json())
6  .then(data => console.log(data.submissions));

Security Notes

Do not expose API keys in frontend code
Use this API from a backend or server environment
Rotate keys periodically

How is this guide?

Authentication

FAQ