POST

Query Pool Definition Items


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Retrieves a list of up to 1,000 pool definition items based on the specified paging, filtering, and sorting. To learn how to query pool definition items, see API Query Language.

Pass 1 or more values in the fields parameter to populate additional data:

  • POOL_DEFINITION: Populates poolDefinition with the pool definition's display name, description, and credit configuration.
  • PROGRAM_DEFINITION: Populates programDefinitions with displayName and description. Use this field to show which plans grant access to a specified item.
  • BENEFIT: Populates benefitInfo with the benefit's credit price, display name, and description.
  • ITEM: Populates itemInfo with the catalog item's display name.

Enrichment data is silently absent if the source data is unavailable.

PropertyFiltersSort
id$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteSort: ASC, DESC
externalId$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteSort: ASC, DESC
providerAppId$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteSort: ASC, DESC
category$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteSort: ASC, DESC
namespace$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteSort: ASC, DESC
poolDefinitionId$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteSort: ASC, DESC
createdDate$eq, $ne, $exists, $in, $hasSome, $lt, $lte, $gt, $gteSort: ASC, DESC
itemSetId$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteSort: ASC, DESC
programDefinitions.id$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteSort: ASC, DESC
programDefinitions.externalId$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteSort: ASC, DESC
benefitKey$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteSort: ASC, DESC
itemSearchKey$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteSort: ASC, DESC
Authentication

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

Permissions
Read benefit programs
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/benefit-programs/v1/pool-definition-items/query

Errors

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

Did this help?