Retrieves a list of items, on the basis of the filtering, sorting, and paging preferences you provide.
Choose between offset and cursor paging:
query.paging (offset) when each request needs its own filter or sort, or when you need returnTotalCount.query.cursorPaging to continue an existing result set by reusing the cursor returned in pagingMetadata.cursors. Define filter and sort on the first request only — follow-up cursor requests should pass only the returned cursor, because filter and sort are ignored on subsequent cursor requests.For date and datetime fields, write filter values as {"$date":"2026-05-05T00:00:00.000Z"} (plain ISO 8601 strings are also accepted).
To inline related items in each result, set includeReferences. If a reference or multi-reference field can contain more items than you want to inline, page the base query first and then call Query Referenced Data Items for the specific item and field you want to expand.
Learn more about API Query Language.
You can only call this method when authenticated as a Wix app or Wix user identity.
This method doesn't return any custom errors, but may return standard errors. Learn more about standard Wix errors.