P
ProFormsDocs

List Submissions

Retrieve a paginated list of form submissions with filtering and search.

submissions.view
GET/v1/submissions

Query Parameters

formIdstring

Filter by form UUID

siteIdstring

Filter by site UUID

isReadstring

Filter by read status: true or false

isStarredstring

Filter starred submissions: true

searchstring

Search across submission data

presetstring

Date preset: today, yesterday, 7d, 30d, 90d, 12m

startDatestring

Custom start date (ISO 8601)

endDatestring

Custom end date (ISO 8601)

pageinteger

Page number (default: 1)

limitinteger

Results per page, 1–100 (default: 25)

sortBystring

Sort field: createdAt, updatedAt (default: createdAt)

sortOrderstring

Sort direction: asc, desc (default: desc)

leadStatusstring

Filter by lead status: pending, qualified, not_qualified, spam

sourcestring

Filter by submission source: form, webhook

Example Request

curl
curl "https://proforms.io/api/v1/submissions?formId=f_abc123&isRead=false&limit=10" \
  -H "Authorization: Bearer pf_your_api_key"

Response

200 OK
{
  "success": true,
  "data": {
    "submissions": [
      {
        "id": "sub_def456",
        "referenceId": "CF-0042",
        "formId": "f_abc123",
        "formName": "Contact Form",
        "siteId": "s_xyz789",
        "siteName": "Main Website",
        "previewFields": [
          {
            "label": "Name",
            "value": "John Smith"
          },
          {
            "label": "Email",
            "value": "john@example.com"
          },
          {
            "label": "Message",
            "value": "I'd like a quote for web design"
          }
        ],
        "isRead": false,
        "isStarred": false,
        "isSpam": false,
        "isTest": false,
        "createdAt": "2026-02-17T09:15:00.000Z"
      }
    ],
    "total": 42,
    "page": 1,
    "limit": 10,
    "totalPages": 5
  }
}
💡
The list endpoint returns previewFields (the first 3 non-layout fields) instead of the full data object. Use Get Submission for the complete submission data.