POST

Query Referenced Data Items


Retrieves the full items referenced in the specified field of an item.

Call this method when a reference or multi-reference field can contain more related items than you want to inline with includeReferences on Query Data Items, or when you want to expand one specific item's references after paging a base query.

Reference and multi-reference fields refer to items in different collections. This method retrieves the full details of the referenced items themselves.

For example, suppose you have a Movies collection with an Actors field that contains references to items in a People collection. Querying the Movies collection using this method returns the relevant People items referenced in the Actors field of the specified Movie item. This gives you information from the People collection about each of the actors in the specified movie.

Authentication

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

Permissions
Read Data Items
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/wix-data/v2/items/query-referenced

Errors

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

Did this help?