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.
| Property | Filters | Sort |
|---|---|---|
_id | $eq, $in, $ne, $nin | Sort: ASC, DESC |
formId | $eq, $in, $ne, $nin | Sort: ASC, DESC |
contactId | $eq, $in, $ne, $nin | Sort: ASC, DESC |
namespace | $eq | None |
status | $eq, $in, $ne, $nin | Sort: ASC, DESC |
seen | $eq, $ne | Sort: ASC, DESC |
_createdDate | $eq, $gt, $gte, $in, $lt, $lte, $ne, $nin | Sort: ASC, DESC |
_updatedDate | $eq, $gt, $gte, $in, $lt, $lte, $ne, $nin | Sort: ASC, DESC |
submitter.memberId | $eq, $in, $ne, $nin | Sort: ASC, DESC |
submitter.visitorId | $eq, $in, $ne, $nin | Sort: ASC, DESC |
submitter.applicationId | $eq, $in, $ne, $nin | Sort: ASC, DESC |
submitter.userId | $eq, $in, $ne, $nin | Sort: ASC, DESC |
orderDetails.checkoutId | $eq, $in, $ne, $nin | Sort: ASC, DESC |
This method may require higher-level permissions than the caller has, based on their identity and roles and permissions. In these cases, you can ensure the method is called with the required level of authorization by using one of the following:
This method doesn't return any custom errors, but may return standard errors. Learn more about standard Wix errors.