> 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/wishlist-items/get-wishlist-items-updated-since-a-timestamp.md).

# Get wishlist items updated since a timestamp

Returns wishlist items updated after the supplied ISO-8601 timestamp for incremental synchronisation. Results are scoped to the caller's tenant and ordered by `updatedDate`.

Pagination uses the `lastItemId` and `lastItemDate` values returned by the previous response. Supply both cursor values together on the next request. They are `null` when no further page is available.

Because an item updated during a paginated sweep may move position, consumers should use overlapping `updatedSince` windows and de-duplicate by wishlist item ID when performing periodic synchronisation.

```json
{"openapi":"3.0.3","info":{"title":"Wishlist REST API","version":"0.0.1"},"tags":[{"name":"wishlist-items","description":"Add, update, remove and query the items on a wishlist."}],"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 <token>`."}}},"paths":{"/api/wishlist/item/updatedSince":{"get":{"summary":"Get wishlist items updated since a timestamp","description":"Returns wishlist items updated after the supplied ISO-8601 timestamp for incremental synchronisation. Results are scoped to the caller's tenant and ordered by `updatedDate`.\n\nPagination uses the `lastItemId` and `lastItemDate` values returned by the previous response. Supply both cursor values together on the next request. They are `null` when no further page is available.\n\nBecause an item updated during a paginated sweep may move position, consumers should use overlapping `updatedSince` windows and de-duplicate by wishlist item ID when performing periodic synchronisation.","operationId":"getWishlistItemsUpdatedSince","tags":["wishlist-items"],"parameters":[{"in":"header","name":"X-TWC-Tenant","required":true,"description":"Tenant key (the retail store's unique identifier in TWC).","schema":{"type":"string"}},{"in":"query","name":"updatedSince","required":true,"description":"ISO-8601 instant. Only items whose `updatedDate` is strictly greater than this value are returned.","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"lastItemId","description":"Wishlist item ID cursor from the previous response. Must be supplied together with `lastItemDate`.","schema":{"type":"string"}},{"in":"query","name":"lastItemDate","description":"Updated-date cursor from the previous response. Must be supplied together with `lastItemId`.","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"pageSize","description":"Number of wishlist items to return. Defaults to 20 and is capped at 50.","schema":{"type":"integer","default":20,"maximum":50,"minimum":1}}],"responses":{"200":{"description":"Wishlist items updated after the supplied timestamp.","content":{"application/json":{"schema":{"type":"object","required":["itemCount","items"],"properties":{"itemCount":{"type":"integer","minimum":0},"lastItemId":{"type":"string","nullable":true},"lastItemDate":{"type":"string","format":"date-time","nullable":true},"items":{"type":"array","items":{"type":"object","properties":{"wishlistItemId":{"type":"string"},"wishlistId":{"type":"string"},"customerId":{"type":"string"},"customerRef":{"type":"string"},"productRef":{"type":"string"},"variantRef":{"type":"string"},"addedFromCart":{"type":"boolean"},"purchased":{"type":"boolean"},"purchasedAndRemoved":{"type":"boolean"},"deleted":{"type":"boolean"},"datePurchased":{"type":"string","format":"date-time","nullable":true},"createdDate":{"type":"string","format":"date-time"},"updatedDate":{"type":"string","format":"date-time"}}}}}}}}},"400":{"description":"The `updatedSince` value is missing, blank, or is not a valid ISO-8601 instant.","content":{"application/json":{"schema":{"type":"string"}}}}}}}}}
```