POST

Query Contacts


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.

FieldSupported FiltersSort
id$eq, $ne, $in, $existsSort: ✗
info.locale$eq, $ne, $in, $existsSort: ✗
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, $lteSort: ✗
primaryInfo.email$eq, $ne, $in, $exists, $beginsSort: ASC, DESC
info.name.first$eq, $ne, $in, $exists, $beginsSort: ASC, DESC
info.name.last$eq, $ne, $in, $exists, $beginsSort: ASC, DESC
info.company$eq, $ne, $in, $exists, $beginsSort: ASC, DESC
info.jobTitle$eq, $ne, $in, $exists, $beginsSort: ASC, DESC
primaryInfo.phone$eq, $ne, $in, $exists, $beginsSort: ✗
info.labelKeys$hasSome, $hasAllSort: ✗
Authentication

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

Permissions
Read Contacts
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/contacts/v4/contacts/query

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?