Get Default List


This service enables users to retrieve a default list. This particular call is for unauthenticated (guest) users.

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


Request Body Parameters
Parameter Description Mandatory Sample Value


The userid assigned to the user Yes 9190455502
userguid The user Guid assigned to the user Yes 6beadb27-8ee3-4394-a76c-757db7ac0dd2


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

    "lists": {
        "lists": [
                "listGuid": "a64a92fb-7eee-4ba8-97f9-a9baa826d14b",
                "name": "John Doe's List",
                "defaultList": true,
                "onSaleNotify": false,
                "searchable": false,
                "numberOfItems": 0,
                "filterResultItem": 0,
                "showPurchaseInfo": true,
                "createdDate": "2015-03-19 18:02:10.900054",
                "lastModified": "2015-03-19 18:02:10.900054",
                "links": [
                        "rel": "user",
                        "ref": ""
                        "rel": "SELF",
                        "ref": ""
                "user": {
                    "id": 9190455502,
                    "guid": "4f212734-34bd-493c-89e9-20a178405b40",
                    "profileAddress": {
                        "firstName": "John",
                        "lastName": "Doe",
                        "state": "CA"
                    "passwordSplashScreenEnabled": false,
                    "guestUser": false


cURL Example

curl -X GET -H "X-Macys-Webservice-Client-Id: xxxxxxxxx" -H "Accept: application/json" -H ""



back to top

Error Codes

Call Specific Error Codes:

  • Error Code: 10103 Error Message : Either user id or user guid missing or invalid

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

  • Error Code: 100105 Error Message : Invalid list type

  • Error Code: 100106 Error Message : Requested Functionality not supported currently

  • Error Code: 100108 Error Message : Unsupported sort by value

  • Error Code: 100109 Error Message : Invalid sort order value. Valid values are asc/desc

  • Error Code: 100110 Error Message : Unable to find upc/product info from fcc

  • Error Code: 100111 Error Message : Incorrect request

  • Error Code: 100117 Error Message : Invalid User


General Error Handling Documentation:

Click Here

back to top

Docs Navigation