Query Premium Assets

Retrieves a list of up to 100 Premium assets, given the provided paging, filtering, and sorting.

Query Premium Assets runs with these defaults, which you can override:

• cursorPaging.limit is 50

Pass the ID of the account whose assets you want to retrieve in the targetAccountId header. The call fails without it.

Which assets are returned depends on what the caller is permitted on. A caller permitted on the target account receives all of the account's assets. A caller permitted only on a specific site receives that site's assets alone, and the results are filtered to that site. In the second case the site is taken from the call scope, so a call with neither an account permission nor a site in scope fails.

Assets for which the account is Billing Manager aren't returned by default. Pass {"includePermitted": true} to include them. Sort isn't guaranteed to be applied when includePermitted is true.

Sorting applies to the first page of results. Following requests use the cursor token, which already carries the sort from the first call.

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