> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Pool Definition Items

# Type: Pool Definition Item Object

# Link: https://dev.wix.com/docs/api-reference/business-solutions/benefit-programs/pool-definition-items/pool-definition-item-object.md

## Description: An assignment of a catalog item to a benefit in a pool definition.

## Schema:

```json
 Type: Pool Definition Item Object | type: PoolDefinitionItem
 Description: An assignment of a catalog item to a benefit in a pool definition.
       - name: id  | type: string | description: Benefit item ID. Deterministically generated from pool_definition_id and item_id — if you know both, you can compute the ID without querying.
       - name: revision  | type: string | description: Revision number, which increments by 1 each time the benefit item is updated.
           - name: value  | type: string | description: 
       - name: createdDate  | type: string | description: Date and time the item was created.
           - name: seconds  | type: string | description: 
           - name: nanos  | type: number | description: 
       - name: updatedDate  | type: string | description: Date and time the item was updated.
       - name: externalId  | type: string | description: External item ID assigned by the provider of the items.  For example, if the benefit items are products, this ID corresponds to the specific product ID in the provider's system.
       - name: category  | type: string | description: Item category. Groups benefit items together for organization and management purposes. For example, classes, posts, groups.
       - name: providerAppId  | type: string | description: ID of the application providing the benefit items. Each item's external_id is unique within its provider application.
       - name: namespace  | type: string | description: Namespace for your app or site's benefit programs. Namespaces allow you to distinguish between entities that you created and entities that other apps created.
       - name: poolDefinitionId  | type: string | description: ID of the pool definition - the configuration that defines a set of benefits and which items are accessible within each benefit.
       - name: itemSetId  | type: string | description: Internal grouping identifier for this benefit's item set. Use pool_definition_id together with benefit_key to identify a benefit — item_set_id is an implementation detail.
       - name: poolDefinition  | type: PoolDefinitionInfo | description: Pool definition details including display name, description, and credit settings. Only populated when POOL_DEFINITION is included in the fields request parameter.
           - name: displayName  | type: string | description: Pool definition name.
           - name: description  | type: string | description: Pool definition description.
               - name: value  | type: string | description: 
           - name: creditConfiguration  | type: CreditConfiguration | description: Credit configuration for this pool definition. When absent, benefits in this pool do not support credit-based pricing.
               - name: amount  | type: string | description: Number of credits initially granted to a subscriber when this pool definition's benefits are activated.
               - name: unitDisplayName  | type: string | description: Credit unit display name.
               - name: unitType  | type: string | description: Credit unit type.
       - name: programDefinitions  | type: Array<ProgramDefinitionInfo> | description: Program definitions that include this item as an accessible benefit. Only id and external_id are returned by default; request PROGRAM_DEFINITION to include display_name and description.
           - name: id  | type: string | description: Program definition id
           - name: externalId  | type: string | description: Program definition external id
           - name: displayName  | type: string | description: Program definition name
           - name: description  | type: string | description: Program definition description.
       - name: itemId  | type: string | description: Item ID.
       - name: benefitInfo  | type: BenefitInfo | description: Pricing and display information for the associated benefit, including credit price, name, and description. Only populated when BENEFIT is included in the fields request parameter.
           - name: price  | type: string | description: Price of the benefit in credits. The price is the same for all of this benefit's items.
           - name: displayName  | type: string | description: Benefit name.
           - name: description  | type: string | description: Benefit description.
       - name: itemInfo  | type: ItemInfo | description: Display name for the catalog item. Only populated when ITEM is included in the fields request parameter.
           - name: displayName  | type: string | description: Item display name.
       - name: benefitKey  | type: string | description: Unique identifier for the benefit associated with this item.
       - name: itemSearchKey  | type: string | description: Pre-computed search key for the item reference, built by concatenating provider_app_id, category, and external_id separated by /. Use this field for efficient single-field filtering instead of composing three separate conditions.
       - name: removed  | type: boolean | description: Whether this item has been removed from the pool definition.
           - name: value  | type: boolean | description: 

```