POST

Count Submissions

Note: The Form Submission API only works with the Wix Forms app. Call GetAppInstance to confirm that the app named wix_forms is installed on the site.


Counts the number of submissions belonging to the specified forms.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Submissions
Read Submissions
Manage Orders
Read Orders
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/form-submission-service/v4/submissions/count
Body Params
formIdsArray <string>Requiredformat GUIDminItems 1maxItems 100

Form IDs.

namespacestringRequiredminLength 10maxLength 50

Identifies the app which the form submissions belong to. For example, the namespace for the Wix Forms App is "wix.form_app.form". The namespace of a submission can be retrieved using the Get Submission endpoint.

statusesArray <string>maxItems 4

List of statuses of submissions which should be taken into count Default: CONFIRMED, PAYMENT_WAITING, PAYMENT_CANCELED

Response Object
formsSubmissionsCountArray <FormSubmissionsCount>

Forms submission count.

Count Submissions Example 1
Request
cURL
curl -X POST \
  'http://www.wixapis.com/form-submission/v4/submissions/count' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <AUTH>' \
  -d '{
    "formIds": [
      "e62e3011-55cf-4de3-a497-e097b52d86b8"
    ],
    "namespace": "wix.form_app.form"
  }'
Response
JSON
{
  "formsSubmissionsCount": [
    {
      "formId": "e62e3011-55cf-4de3-a497-e097b52d86b8",
      "totalCount": 2,
      "unseenCount": 1
    }
  ]
}
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?