POST

Query Contacts


Note: This query method uses the new Wix API Query Language syntax. If you're still using the old query syntax with chained query builder methods, see Migrate from SDK Query Builders to Wix API Query Language for guidance. The old query builder methods continue to work.

Retrieves a list of contacts, given the provided paging, filtering, and sorting.

Up to 1,000 contacts can be returned per request. Query Contacts runs with these defaults, which you can override:

  • createdDate is sorted in ASC order
  • paging.limit is 50
  • paging.offset is 0

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

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

PropertyFiltersSort
_id$eq, $ne, $in, $existsNone
info.locale$eq, $ne, $in, $existsNone
_createdDate$eq, $ne, $gt, $lt, $gte, $lteSort: ASC, DESC
lastActivity.activityDate$eq, $ne, $gt, $lt, $gte, $lteSort: ASC, DESC
info.birthdate$eq, $ne, $gt, $lt, $gte, $lteSort: ASC, DESC
_updatedDate$eq, $ne, $gt, $lt, $gte, $lteNone
primaryInfo.email$eq, $ne, $in, $exists, $startsWithSort: ASC, DESC
info.name.first$eq, $ne, $in, $exists, $startsWithSort: ASC, DESC
info.name.last$eq, $ne, $in, $exists, $startsWithSort: ASC, DESC
info.company$eq, $ne, $in, $exists, $startsWithSort: ASC, DESC
info.jobTitle$eq, $ne, $in, $exists, $startsWithSort: ASC, DESC
primaryInfo.phone$eq, $ne, $in, $exists, $startsWithNone
info.labelKeys$hasSome, $hasAllNone
Authentication

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:

Permissions
Read Contacts
Learn more about app permissions.
Method Declaration
Copy
Errors
400Invalid Argument

There are 8 errors with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Did this help?