This feature is marked as beta and may be affected by changes. Use with caution for production.

My Shopping Lists

This endpoint can only be used with an access token created with the password flow or with an anonymous session. It gives access to shopping lists that belong to the customer or the anonymous session linked to the access token.

Representations

All representations are JSON objects submitted or received as payload to API requests or responses. Responses are equal to the responses on the shopping list endpoint, but requests may differ.

MyShoppingListDraft

A MyShoppingListDraft is the object submitted as payload to the Create MyShoppingList method. The customer field of ShoppingList is automatically set with a password flow token. The anonymousId is automatically set with a token for an anonymous session. The key and slug fields can not be set.

Get ShoppingList by ID

Endpoint: /{projectKey}/me/shopping-lists/{id}
Method: GET
OAuth2 Scopes: manage_my_shopping_lists:{projectKey}
Response Representation: ShoppingList

Query ShoppingLists

Endpoint: /{projectKey}/me/shopping-lists
Method: GET
OAuth2 Scopes: manage_my_shopping_lists:{projectKey}
Response Representation: PagedQueryResult with the results array of ShoppingList

Query Parameters:

Create a ShoppingList

Endpoint: /{projectKey}/me/shopping-lists
Method: POST
OAuth2 Scopes: manage_my_shopping_lists:{projectKey}
Request Representation: MyShoppingListDraft
Response Representation: ShoppingList

Update ShoppingList

Endpoint: /{projectKey}/me/shopping-lists/{id}
Method: POST
OAuth2 Scopes: manage_my_shopping_lists:{projectKey}
Response Representation: ShoppingList
Fields:

Update Actions
Please find below the individual update actions provided on this endpoint.


Change Name

As described here.

Set Description

As described here.

Set Custom Type

As described here.

Set CustomField

As described here.

UpdateAction on line item

Add LineItem

As described here.

Remove LineItem

As described here.

Change LineItem Quantity

As described here.

Change LineItems Order

As described here.

Set LineItem Custom Type

As described here.

Set LineItem CustomField

As described here.

UpdateAction on TextLineItem

Add TextLineItem

As described here.

Remove TextLineItem

As described here.

Change TextLineItem Quantity

As described here.

Change TextLineItem Name

As described here.

Set TextLineItem Description

As described here.

Change TextLineItems Order

As described here.

Set TextLineItems Custom Type

As described here.

Set TextLineItems CustomField

As described here.

Set DeleteDaysAfterLastModification

As described here.

Delete ShoppingList

Removes a ShoppingList.

Endpoint: /{projectKey}/me/shopping-lists/{id}
Method: DELETE
OAuth2 Scopes: manage_my_shopping_lists:{projectKey}
Response Representation: ShoppingList
Query parameters: