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

# getCustomersWithFlag

Get a list of customers who have wishlist items that have either the **notifyMe** or **preRelease** flag set. These flags are used in scenarios such as 'notify me when an item is back in stock', or for a consumer to flag their interest in an upcoming product range.

**notifyMe** or **preRelease** must be specified.

```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 <token>`."}},"parameters":{"notifyMe":{"name":"notifyMe","in":"query","required":false,"description":"notifyMe indicates the customer has asked to be notified of an event (usually back-in-stock)","schema":{"type":"string"}},"preRelease":{"name":"preRelease","in":"query","required":false,"description":"preRelease indicates the customer has an interest in a product that will be available in the future","schema":{"type":"string"}},"productRef":{"name":"productRef","in":"query","required":false,"description":"The retailer's unique identifier for a parent product.   For Shopify this is the Shopify product id.","schema":{"type":"string"}},"variantRef":{"name":"variantRef","in":"query","required":false,"description":"The retailer's unique identifier for a product variant.  For Shopify this is the variant ID.","schema":{"type":"string"}},"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":{"CustomerDto":{"type":"object","properties":{"accepts_marketing":{"type":"boolean"},"active":{"type":"boolean"},"addresses":{"type":"array","items":{"$ref":"#/components/schemas/AddressDto"}},"attributeGroups":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/CustomerAttributeGroupDto"}},"createdDate":{"type":"string","format":"date-time"},"customerRef":{"type":"string"},"customer_state":{"type":"string","enum":["disabled","invited","enabled","declined"]},"defaultAddress":{"$ref":"#/components/schemas/AddressDto"},"dob":{"type":"string","format":"date-time"},"email":{"type":"string"},"firstName":{"type":"string","description":"first_name"},"id":{"type":"string"},"lastModifiedDate":{"type":"string","format":"date-time"},"lastName":{"type":"string","description":"last_name"},"marketing_optin_level":{"type":"string","enum":["single_opt_in","confirmed_opt_in","unknown"]},"marketing_preferences_updated_at":{"type":"string","format":"date-time"},"mobile":{"type":"string"},"phone":{"type":"string"},"taxExempt":{"type":"boolean","description":"tax_exempt"},"taxExemptions":{"type":"array","description":"tax_exemptions","items":{"type":"string"}},"verified_email":{"type":"boolean"}},"title":"CustomerDto"},"AddressDto":{"type":"object","properties":{"address1":{"type":"string"},"address2":{"type":"string"},"addressName":{"type":"string"},"city":{"type":"string"},"company":{"type":"string"},"country":{"type":"string"},"countryCode":{"type":"string"},"customerId":{"type":"string"},"defaultAddress":{"type":"boolean","description":"default_address"},"email":{"type":"string"},"firstName":{"type":"string"},"id":{"type":"string"},"lastName":{"type":"string"},"phone":{"type":"string"},"postcode":{"type":"string"},"province":{"type":"string"},"provinceCode":{"type":"string"}},"title":"AddressDto"},"CustomerAttributeGroupDto":{"type":"object","properties":{"attributes":{"type":"object","additionalProperties":{"type":"string"}},"description":{"type":"string"}},"title":"CustomerAttributeGroupDto"}}},"paths":{"/api/wishlist/items/getCustomersWithFlag":{"get":{"summary":"getCustomersWithFlag","operationId":"getCustomersWithFlagUsingGET","parameters":[{"$ref":"#/components/parameters/notifyMe"},{"$ref":"#/components/parameters/preRelease"},{"$ref":"#/components/parameters/productRef"},{"$ref":"#/components/parameters/variantRef"},{"$ref":"#/components/parameters/X-TWC-Tenant-2"}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CustomerDto"}}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"deprecated":false,"description":"Get a list of customers who have wishlist items that have either the **notifyMe** or **preRelease** flag set.\nThese flags are used in scenarios such as 'notify me when an item is back in stock', or for a consumer to flag their interest in an upcoming product range.  \n\n**notifyMe** or **preRelease** must be specified.","tags":["notify-me"]}}}}
```