• Register

Delete Item from List


This service enables users to delete a specific item from a list 

NOTE: If no user or list is specified when adding an item, a guest list is created. To merge your guest list to an authenticated user, please follow merge list.

back to top

HTTP Method and Request URL



back to top

HTTP, Path and Query Parameters

HTTP Header Parameters

Parameter Description Mandatory Sample Value
x-macys-webservice-client-id Pass the apikey as a header value which is called x-macys-webservice-client-id. The api key is the 24 character alphanumeric string assigned to your application when you registered it. Click here for a list of your API keys. Yes


Accept Specifies the output format. Can be application/json or application/xml. Yes


Content-Type Specifies the format of body sent. Can be application/json or application/xml. Yes



Request Body Parameters
Parameter Description Mandatory Sample Value                                       
listGuid The List GUID assigned to the list YES c779e73f-4f40-40d8-8fee-d42a1a9cb9d7
userguid The user Guid assigned to the user Yes See sample payload below


back to top


Sample Requests and Responses

Sample Request

Request URL:




Sample Header:

X-Macys-Webservice-Client-Id: xmj9js4jkdpe1983fmwu98gh
Accept: application/json
Content-type: application/json

Sample Response


back to top

cUrl Example

curl -X DELETE -H "X-Macys-Webservice-Client-ID: XXXXXXXXXX" -H "Accept: application/json" "http://api.macys.com/customer/v1/lists/a64a92fb-7eee-4ba8-98f9-a9baa826d14b/items/c243c25e-4459-43b6-9304-19ae1245388a"


Error Codes

Call Specific Error Codes

  • Error Code: 10111 Error Message : Incorrect request

  • Error Code: 10122 Error Message : Invalid list Guid

  • Error Code: 10104 Error Message : List type not supported

General Error Handling Documentation:

Click Here

back to top

Docs Navigation