# Associate Shopping Lists

Associate Shopping Lists allow [Associates](/api/projects/business-units.md#associate) to interact with [Shopping Lists](/api/projects/shoppingLists.md) on behalf of a [Business Unit](/api/projects/business-units.md).

Associates can view, create, update, and delete Shopping Lists on behalf of a Business Unit. The actions a given Associate is allowed to perform depends on the specific [roles and permissions](/api/associates-overview.md#associate-roles-and-permissions) they hold within the Business Unit.

Learn more about using Shopping Lists for B2B procurement and repeat purchasing in our self-paced [Discover and order products in B2B](/learning-model-b2b-commerce/discover-and-order-products-in-b2b/shopping-lists-for-b2b-purchasing.md) module.

## Get ShoppingList in BusinessUnit as Associate

The Associate must have the `ViewMyShoppingLists` or `ViewOthersShoppingLists` [Permission](/search.md?urn=ctp:api:type:Permission). If the required Permission is missing, an [AssociateMissingPermission](/search.md?urn=ctp:api:type:AssociateMissingPermissionError) error is returned.

### Get ShoppingList in BusinessUnit by ID as Associate

[endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/as-associate/{associateId}/in-business-unit/key={businessUnitKey}/shopping-lists/{id}:GET).

### Get ShoppingList in BusinessUnit by Key as Associate

[endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/as-associate/{associateId}/in-business-unit/key={businessUnitKey}/shopping-lists/key={key}:GET).

## Query ShoppingLists in BusinessUnit as Associate

[endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/as-associate/{associateId}/in-business-unit/key={businessUnitKey}/shopping-lists:GET).

## Check if ShoppingList exists in BusinessUnit as Associate

Whether a Shopping List is visible to the Associate depends on their role and the associated [Permissions](/api/projects/associate-roles.md#permission).

### Check if ShoppingList exists in BusinessUnit by ID as Associate

[endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/as-associate/{associateId}/in-business-unit/key={businessUnitKey}/shopping-lists/{id}:HEAD).

### Check if ShoppingList exists in BusinessUnit by Key as Associate

[endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/as-associate/{associateId}/in-business-unit/key={businessUnitKey}/shopping-lists/key={key}:HEAD).

### Check if ShoppingList exists in BusinessUnit by Query Predicate as Associate

[endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/as-associate/{associateId}/in-business-unit/key={businessUnitKey}/shopping-lists:HEAD).

## Create ShoppingList in BusinessUnit as Associate

The Associate must have the `CreateMyShoppingLists` or `CreateOthersShoppingLists` [Permission](/search.md?urn=ctp:api:type:Permission). If the required Permission is missing, an [AssociateMissingPermission](/search.md?urn=ctp:api:type:AssociateMissingPermissionError) error is returned.

[endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/as-associate/{associateId}/in-business-unit/key={businessUnitKey}/shopping-lists:POST).

## Update ShoppingList in BusinessUnit as Associate

The Associate must have the `UpdateMyShoppingLists` or `UpdateOthersShoppingLists` [Permission](/search.md?urn=ctp:api:type:Permission). If the required Permission is missing, an [AssociateMissingPermission](/search.md?urn=ctp:api:type:AssociateMissingPermissionError) error is returned.

### Update ShoppingList in BusinessUnit by ID as Associate

[endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/as-associate/{associateId}/in-business-unit/key={businessUnitKey}/shopping-lists/{id}:POST).

### Update ShoppingList in BusinessUnit by Key as Associate

[endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/as-associate/{associateId}/in-business-unit/key={businessUnitKey}/shopping-lists/key={key}:POST).

## Delete ShoppingList in BusinessUnit as Associate

The Associate must have the `DeleteMyShoppingLists` or `DeleteOthersShoppingLists` [Permission](/search.md?urn=ctp:api:type:Permission). If the required Permission is missing, an [AssociateMissingPermission](/search.md?urn=ctp:api:type:AssociateMissingPermissionError) error is returned.

### Delete ShoppingList in BusinessUnit by ID as Associate

[endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/as-associate/{associateId}/in-business-unit/key={businessUnitKey}/shopping-lists/{id}:DELETE).

### Delete ShoppingList in BusinessUnit by Key as Associate

[endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/as-associate/{associateId}/in-business-unit/key={businessUnitKey}/shopping-lists/key={key}:DELETE).

## Related pages

- [Area overview page with navigation](/api.md)
- [Previous page: Associate Business Units](/api/projects/associate-business-units.md)
- [Search documentation and API specs](/search.md)