> 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/check-wishlist-item-status.md).

# Check wishlist item status

This endpoint is used to check whether one or more product variants (by variantRef) exist in a customer's wishlist. It returns a map of each variant and its presence (true/false).

You can use customerId, customerRef or customerEmail to identify the customer.

Pass a product list, and if the customer has that item on one of their wishlists, it will return as True

You must include a valid Bearer token in the Authorization header:

Authorization: Bearer You must also pass the tenant key:

X-TWC-Tenant: \<tenant\_id> For example:

X-TWC-Tenant: twcfashionstaging 📝 Request Headers

Header Value (example) Content-Type application/json Authorization Bearer X-TWC-Tenant twcfashionstaging (or your tenant slug) Cookie (optional) includes session cookies like XSRF-TOKEN and tsvchash (used for UI sessions)

📦 Request Body

{ "customerId": "5ecee24e-2473-4d28-b4ca-e39495b61b02", "variantRef": \[ "46906452377916", "46906452377917", "46906405323068", "VYSAKH-007-1" ] }

```fields:
Field Type	Required	Description
customerId	string	✅ Yes	The UUID of the customer whose wishlist you're checking
variantRef	array	✅ Yes	List of variant IDs (can be Shopify variant IDs or custom)
```

✅ Example Success Response

{ "46906452377916": true, "46906452377917": false, "46906405323068": true, "VYSAKH-007-1": false } This response tells you which variantRefs exist in the customer's wishlist:

````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/itemStatus":{"post":{"summary":"Check wishlist item status","tags":["wishlist-items"],"responses":{},"operationId":"post-api-wishlist-itemStatus","description":"This endpoint is used to check whether one or more product variants (by variantRef) exist in a customer's wishlist. It returns a map of each variant and its presence (true/false).\n\nYou can use customerId, customerRef or customerEmail to identify the customer.\n\nPass a product list, and if the customer has that item on one of their wishlists, it will return as True\n\nYou must include a valid Bearer token in the Authorization header:\n\nAuthorization: Bearer <JWT>\nYou must also pass the tenant key:\n\nX-TWC-Tenant: <tenant_id>\nFor example:\n\nX-TWC-Tenant: twcfashionstaging\n📝 Request Headers\n\nHeader\tValue (example)\nContent-Type\tapplication/json\nAuthorization\tBearer <JWT>\nX-TWC-Tenant\ttwcfashionstaging (or your tenant slug)\nCookie (optional)\tincludes session cookies like XSRF-TOKEN and tsvchash (used for UI sessions)\n\n📦 Request Body\n\n{\n  \"customerId\": \"5ecee24e-2473-4d28-b4ca-e39495b61b02\",\n  \"variantRef\": [\n    \"46906452377916\",\n    \"46906452377917\",\n    \"46906405323068\",\n    \"VYSAKH-007-1\"\n  ]\n}\n\n```Fields:\nField Type\tRequired\tDescription\ncustomerId\tstring\t✅ Yes\tThe UUID of the customer whose wishlist you're checking\nvariantRef\tarray\t✅ Yes\tList of variant IDs (can be Shopify variant IDs or custom)\n```\n✅ Example Success Response\n\n{\n  \"46906452377916\": true,\n  \"46906452377917\": false,\n  \"46906405323068\": true,\n  \"VYSAKH-007-1\": false\n}\nThis response tells you which variantRefs exist in the customer's wishlist:\n\n"}}}}
````