> For the complete documentation index, see [llms.txt](https://the-wishlist-documentation.gitbook.io/the-wishlist-documentation-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://the-wishlist-documentation.gitbook.io/the-wishlist-documentation-docs/wishlist-rest-api/notify-me/getnotifymeitems.md). # getNotifyMeItems This API allows clients to fetch **Notify Me wishlist items** incrementally using an `updated_after` timestamp. The data is **sorted by updatedDate** and supports **cursor-based pagination**. This endpoint supports: * You can filter the items based on status (pending/sent/all). * You can return all notifyMe items after a given date * You can specify a specific SKU to return (default is to return all SKUs) Note: Filters do NOT affect sorting and may reduce the number of returned items per page. Sample Curl Request curl --location ' \--header 'X-TWC-Tenant: twcfashionstaging'\ \--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJyQVBqZzRCRlVNdHgtQ0F3SElQZklVYkF3TVdFcjg5STVYZ29JR25KQnQ0In0.eyJleHAiOjE3NjE2NjA0NTcsImlhdCI6MTc2MTY0MjQ1NywianRpIjoiNWE1YmQyNjAtYThjMi00OWNmLWI3MjMtNTc5ODBiZGM1ZWUxIiwiaXNzIjoiaHR0cHM6Ly9hdXRoLmF1LXNhbmRib3gudGhld2lzaGxpc3QuaW8vYXV0aC9yZWFsbXMvc3VuaWxzX2VsZWN0cm9uaWNzIiwiYXVkIjoiYWNjb3VudCIsInN1YiI6IjkyNjFlMDc4LWVhMzUtNDQxOC04ODc5LWVkNjI3NjgxYWRmZCIsInR5cCI6IkJlYXJlciIsImF6cCI6InR3Y19hZG1pbiIsImFsbG93ZWQtb3JpZ2lucyI6WyJodHRwOi8vY29uc29sZS5zYW5kYm94LnRoZXdpc2hsaXN0LmlvIiwiaHR0cDovL2FwaS5zYW5kYm94LnRoZXdpc2hsaXN0LmlvIl0sInJlYWxtX2FjY2VzcyI6eyJyb2xlcyI6WyJvZmZsaW5lX2FjY2VzcyIsInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsiYWNjb3VudCI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsIm1hbmFnZS1hY2NvdW50LWxpbmtzIiwidmlldy1wcm9maWxlIl19fSwic2NvcGUiOiJlbWFpbCBwcm9maWxlIiwiY2xpZW50SWQiOiJ0d2NfYWRtaW4iLCJlbWFpbF92ZXJpZmllZCI6ZmFsc2UsImNsaWVudEhvc3QiOiIxOTIuMTY4LjE4Ni4xMjUiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJzZXJ2aWNlLWFjY291bnQtdHdjX2FkbWluIiwiY2xpZW50QWRkcmVzcyI6IjE5Mi4xNjguMTg2LjEyNSJ9.JywukLWj3BWZJnKgP1cneq9qh2iapt6xH8yap9vSXX1LkWnzM-apipXCcomBkEC8n3CeH4NzuXoq4jX\_VR5FQAA53llwUq9HDL6eHDxJwQzpD\_GB3qsl7XnM6dXrca\_K5KhtCwqOCbewhvZKQ6G9v4c\_7Rs8IADVyhF2MDVFoFcgzKwBwOG\_E4f8a3RsC\_9zFC-soYzM2c2iPSpHRNIbvyWQbhKPgm9YFJkxeB7uvA0pzF339RwY1fpPyFAbQ4xpgTZUUU\_IlYSyEZF6NIoCh2tj\_F8c36UToXxyvsugcw3cyGJ1I6uoYHaa8\_xVuC2jkm40EntV1YV3UzYbRLiA3w'\ \--header 'Cookie: XSRF-TOKEN=ab79caf0-e571-45b9-86bd-bc7d01645017'\ \--data '' *** ### Pagination The pagination token is derived from the **last item returned in the response**: * `lastItemId` * `lastItemDate` (updatedDate) These values uniquely identify the last evaluated item. *** #### Request Parameters | Parameter | Required | Description | | --------------- | -------- | ------------------------------------------ | | `updated_after` | ✅ | ISO timestamp to start fetching updates | | `pageSize` | ❌ | Max items per request (default 20, max 30) | | `lastItemId` | ❌ | Cursor value from previous response | | `lastItemDate` | ❌ | Cursor value from previous response | | `type` | ❌ | all / pending / sent | | `sku` | ❌ | Variant reference | *** #### First Request Example ``` GET /wishlist/item/notifyMe?updated_after=2025-01-01T00:00:00&pageSize=20 ``` Response: ```json { "itemCount": 2, "lastItemId": "75dc6d69-0c3a-45d0-ac3e-0bc7efc08a6f", "lastItemDate": "2026-01-19T15:58:08.772", "items": [ ... ] } ``` *** #### Next Page Request Client must send back **both cursor values exactly as received**: ``` GET /wishlist/item/notifyMe? updated_after=2025-01-01T00:00:00& lastItemId=75dc6d69-0c3a-45d0-ac3e-0bc7efc08a6f& lastItemDate=2026-01-19T15:58:08.772& pageSize=20 ``` *** ````json {"openapi":"3.0.3","info":{"title":"Wishlist REST API","version":"0.0.1"},"tags":[{"name":"notify-me","description":"Notify Me / register-interest items and the notification flags used to drive them."}],"servers":[{"url":"https://api.au-aws.thewishlist.io/services/wsservice"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"OAuth2 bearer token issued by TWC Keycloak, sent as `Bearer `."}}},"paths":{"/api/wishlist/item/notifyMe":{"get":{"summary":"getNotifyMeItems","tags":["notify-me"],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","properties":{"itemCount":{"type":"integer"},"lastItemId":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"variantRef":{"type":"string"},"productRef":{"type":"string"},"SKU":{"type":"string"},"customerRef":{"type":"string"},"customerEmail":{"type":"string"},"createdDate":{"type":"string"},"status":{"type":"string"},"sentDate":{"type":"string","nullable":true}}}}}}},"Example 1":{}}}},"operationId":"getNotifyMeItems","description":"This API allows clients to fetch **Notify Me wishlist items** incrementally using an `updated_after` timestamp. The data is **sorted by updatedDate** and supports **cursor-based pagination**.\n\nThis endpoint supports:\n- You can filter the items based on status (pending/sent/all).\n- You can return all notifyMe items after a given date\n- You can specify a specific SKU to return (default is to return all SKUs)\n\nNote: Filters do NOT affect sorting and may reduce the number of returned items per page.\n\nSample Curl Request\n\ncurl --location 'https://api.au-sandbox.thewishlist.io/services/wsservice/api/wishlist/item/notifyMe?updated_after=2025-01-01&type=all&sku=XXXXX' \\\n--header 'X-TWC-Tenant: twcfashionstaging' \\\n--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJyQVBqZzRCRlVNdHgtQ0F3SElQZklVYkF3TVdFcjg5STVYZ29JR25KQnQ0In0.eyJleHAiOjE3NjE2NjA0NTcsImlhdCI6MTc2MTY0MjQ1NywianRpIjoiNWE1YmQyNjAtYThjMi00OWNmLWI3MjMtNTc5ODBiZGM1ZWUxIiwiaXNzIjoiaHR0cHM6Ly9hdXRoLmF1LXNhbmRib3gudGhld2lzaGxpc3QuaW8vYXV0aC9yZWFsbXMvc3VuaWxzX2VsZWN0cm9uaWNzIiwiYXVkIjoiYWNjb3VudCIsInN1YiI6IjkyNjFlMDc4LWVhMzUtNDQxOC04ODc5LWVkNjI3NjgxYWRmZCIsInR5cCI6IkJlYXJlciIsImF6cCI6InR3Y19hZG1pbiIsImFsbG93ZWQtb3JpZ2lucyI6WyJodHRwOi8vY29uc29sZS5zYW5kYm94LnRoZXdpc2hsaXN0LmlvIiwiaHR0cDovL2FwaS5zYW5kYm94LnRoZXdpc2hsaXN0LmlvIl0sInJlYWxtX2FjY2VzcyI6eyJyb2xlcyI6WyJvZmZsaW5lX2FjY2VzcyIsInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsiYWNjb3VudCI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsIm1hbmFnZS1hY2NvdW50LWxpbmtzIiwidmlldy1wcm9maWxlIl19fSwic2NvcGUiOiJlbWFpbCBwcm9maWxlIiwiY2xpZW50SWQiOiJ0d2NfYWRtaW4iLCJlbWFpbF92ZXJpZmllZCI6ZmFsc2UsImNsaWVudEhvc3QiOiIxOTIuMTY4LjE4Ni4xMjUiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJzZXJ2aWNlLWFjY291bnQtdHdjX2FkbWluIiwiY2xpZW50QWRkcmVzcyI6IjE5Mi4xNjguMTg2LjEyNSJ9.JywukLWj3BWZJnKgP1cneq9qh2iapt6xH8yap9vSXX1LkWnzM-apipXCcomBkEC8n3CeH4NzuXoq4jX_VR5FQAA53llwUq9HDL6eHDxJwQzpD_GB3qsl7XnM6dXrca_K5KhtCwqOCbewhvZKQ6G9v4c_7Rs8IADVyhF2MDVFoFcgzKwBwOG_E4f8a3RsC_9zFC-soYzM2c2iPSpHRNIbvyWQbhKPgm9YFJkxeB7uvA0pzF339RwY1fpPyFAbQ4xpgTZUUU_IlYSyEZF6NIoCh2tj_F8c36UToXxyvsugcw3cyGJ1I6uoYHaa8_xVuC2jkm40EntV1YV3UzYbRLiA3w' \\\n--header 'Cookie: XSRF-TOKEN=ab79caf0-e571-45b9-86bd-bc7d01645017' \\\n--data ''\n\n---\n\n## Pagination\n\nThe pagination token is derived from the **last item returned in the response**:\n\n* `lastItemId`\n* `lastItemDate` (updatedDate)\n\nThese values uniquely identify the last evaluated item.\n\n---\n\n### Request Parameters\n\n| Parameter | Required | Description |\n| --------------- | -------- | ------------------------------------------ |\n| `updated_after` | ✅ | ISO timestamp to start fetching updates |\n| `pageSize` | ❌ | Max items per request (default 20, max 30) |\n| `lastItemId` | ❌ | Cursor value from previous response |\n| `lastItemDate` | ❌ | Cursor value from previous response |\n| `type` | ❌ | all / pending / sent |\n| `sku` | ❌ | Variant reference |\n\n---\n\n### First Request Example\n\n```\nGET /wishlist/item/notifyMe?updated_after=2025-01-01T00:00:00&pageSize=20\n```\n\nResponse:\n\n```json\n{\n \"itemCount\": 2,\n \"lastItemId\": \"75dc6d69-0c3a-45d0-ac3e-0bc7efc08a6f\",\n \"lastItemDate\": \"2026-01-19T15:58:08.772\",\n \"items\": [ ... ]\n}\n```\n\n---\n\n### Next Page Request\n\nClient must send back **both cursor values exactly as received**:\n\n```\nGET /wishlist/item/notifyMe?\n updated_after=2025-01-01T00:00:00&\n lastItemId=75dc6d69-0c3a-45d0-ac3e-0bc7efc08a6f&\n lastItemDate=2026-01-19T15:58:08.772&\n pageSize=20\n```\n\n---\n","parameters":[{"in":"query","name":"type","description":"filter based on type such as all/pending/sent","schema":{"type":"string"}},{"in":"query","name":"sku","description":"filter based on a specific SKU","schema":{"type":"string"}},{"in":"query","name":"updatedAfter","description":"pass the specific date ","schema":{"type":"string"}},{"in":"query","name":"lastItemId","schema":{"type":"string"}},{"in":"query","name":"pageSize","schema":{"type":"string"}}]}}}} ````