> 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/getwishlistitembyreference.md).

# getWishlistItemByReference

Returns the wishlist item belonging to the given ***wishlistitemRef*** (retailer’s own item identifier).

Note that itemRef is the client’s unique identifier for a wishlist item associated with a single wishlist. It is NOT the productRef, which typically could be the retailer’s product SKU.

Typically, our customers don't use wishlistitemRef, and the usual way to get an individual item would be to use the getWishlistItemById.

If the item does not exist, this method returns a ResourceNotFound error.

```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>`."}},"parameters":{"X-TWC-Tenant-2":{"name":"X-TWC-Tenant","in":"header","required":false,"description":"tenant-key (your retail store's unique identifier in TWC)","schema":{"type":"string"}}},"schemas":{"WishlistItemDto":{"type":"object","properties":{"addedByStaff":{"type":"boolean"},"addedFromCart":{"type":"boolean"},"attributeGroups":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/AttributeGroupDto"}},"createdTime":{"type":"string","format":"date-time"},"datePurchased":{"type":"string","format":"date-time"},"disableNotification":{"type":"boolean"},"id":{"type":"string"},"locationId":{"type":"string"},"locationRef":{"type":"string"},"modifiedTime":{"type":"string","format":"date-time"},"notifyMe":{"type":"boolean"},"prerelease":{"type":"boolean"},"product":{"$ref":"#/components/schemas/ProductDto"},"purchased":{"type":"boolean"},"purchasedAndRemoved":{"type":"boolean"},"staffRef":{"type":"string"},"wishlistId":{"type":"string"},"wishlistItemRef":{"type":"string"},"wishlistRef":{"type":"string"}},"title":"WishlistItemDto"},"AttributeGroupDto":{"type":"object","properties":{"attributes":{"type":"object","additionalProperties":{"type":"string"}},"description":{"type":"string"}},"title":"AttributeGroupDto"},"ProductDto":{"type":"object","properties":{"oldVariantId":{"type":"string"},"oldVariantRef":{"type":"string"},"productId":{"type":"string"},"productRef":{"type":"string"},"selectedVariantId":{"type":"string"},"selectedVariantRef":{"type":"string"}},"title":"ProductDto"}}},"paths":{"/api/wishlist/items/ref/{wishlistItemRef}":{"get":{"summary":"getWishlistItemByReference","operationId":"getWishlistItemByReferenceUsingGET","parameters":[{"name":"wishlistItemRef","in":"path","description":"wishlistItemRef","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/X-TWC-Tenant-2"}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WishlistItemDto"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"description":"Returns the wishlist item belonging to the given ***wishlistitemRef*** (retailer’s own item identifier).\n\nNote that itemRef is the client’s unique identifier for a wishlist item associated with a single wishlist. It is NOT the productRef, which typically could be the retailer’s product SKU.\n\nTypically, our customers don't use wishlistitemRef, and the usual way to get an individual item would be to use the getWishlistItemById.\n\nIf the item does not exist, this method returns a ResourceNotFound error.","tags":["wishlist-items"]}}}}
```