POST

Query Submissions By Namespace


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.


Returns a list of up to 100 submissions, given the provided paging, filtering, and sorting.

You can only query submissions from a specified namespace. Use the query filter on the namespace field, otherwise you will receive an error.

For field support for filters and sorting, see Form Submissions: Supported Filters and Sorting.

To learn about working with Query endpoints, see API Query Language, Sorting and Paging, and Field Projection.

FieldSupported FiltersSort
id$eq, $in, $ne, $ninSort: ASC, DESC
formId$eq, $in, $ne, $ninSort: ASC, DESC
contactId$eq, $in, $ne, $ninSort: ASC, DESC
namespace$eqSort: ✗
status$eq, $in, $ne, $ninSort: ASC, DESC
seen$eq, $neSort: ASC, DESC
createdDate$eq, $gt, $gte, $in, $lt, $lte, $ne, $ninSort: ASC, DESC
updatedDate$eq, $gt, $gte, $in, $lt, $lte, $ne, $ninSort: ASC, DESC
submitter.memberId$eq, $in, $ne, $ninSort: ASC, DESC
submitter.visitorId$eq, $in, $ne, $ninSort: ASC, DESC
submitter.applicationId$eq, $in, $ne, $ninSort: ASC, DESC
submitter.userId$eq, $in, $ne, $ninSort: ASC, DESC
orderDetails.checkoutId$eq, $in, $ne, $ninSort: ASC, DESC
Authentication

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

Permissions
Read Submissions
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/form-submission-service/v4/submissions/namespace/query

Errors

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

Did this help?