> For the complete documentation index, see [llms.txt](https://api.senderwiz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.senderwiz.com/customer/subscribers.md). # Subscribers - [Get All Subscribers](https://api.senderwiz.com/customer/subscribers/get-all-subscribers.md): Retrieve all subscribers associated with a specific list. This endpoint supports pagination and returns subscriber details such as email, status, and source. - [Get One Subscriber](https://api.senderwiz.com/customer/subscribers/get-one-subscriber.md): Retrieve details of a specific subscriber from a list using their unique subscriber UID and list UID. Useful for viewing the subscriber's status, source, and personal information. - [Search Subscriber by Email](https://api.senderwiz.com/customer/subscribers/search-subscriber-by-email.md): Search and retrieve subscriber information from a specific list using the subscriber's email address. This is helpful for quickly locating a contact without knowing their UID. - [Search by Email in All Lists](https://api.senderwiz.com/customer/subscribers/search-by-email-in-all-lists.md): Search for a subscriber by email across all lists associated with the authenticated account. This is helpful when you don’t know which list a subscriber belongs to. - [Search by Custom Fields in a List](https://api.senderwiz.com/customer/subscribers/search-by-custom-fields-in-a-list.md): Search for a subscriber within a specific list using one or more custom field values. This is useful for advanced filtering beyond just email. - [Search Subscribers by Status](https://api.senderwiz.com/customer/subscribers/search-subscribers-by-status.md): Search subscribers by their status (e.g., confirmed, unsubscribed, blacklisted) within a specific list. This is useful for filtering active or inactive contacts. - [Get Blacklisted Subscribers](https://api.senderwiz.com/customer/subscribers/get-blacklisted-subscribers.md): Retrieve all subscribers marked as blacklisted within a specific list. Useful for list cleanup, suppression handling, or filtering. - [Get Confirmed Subscribers](https://api.senderwiz.com/customer/subscribers/get-confirmed-subscribers.md): Retrieve all subscribers with the status confirmed from a specified list. Useful for targeting active and verified contacts. - [Get Unconfirmed Subscribers](https://api.senderwiz.com/customer/subscribers/get-unconfirmed-subscribers.md): Retrieve all subscribers with the status unconfirmed from a specific list. Ideal for tracking pending or inactive opt-in subscribers. - [Get Unsubscribed Subscribers](https://api.senderwiz.com/customer/subscribers/get-unsubscribed-subscribers.md): Retrieve all subscribers with the status unsubscribed from a specific list. Useful for managing opt-outs and analyzing churn. - [Create a Subscriber](https://api.senderwiz.com/customer/subscribers/create-a-subscriber.md): Create a new subscriber in a specific list by submitting their email and any additional custom fields. A confirmation email will be triggered based on the list configuration. - [Create Subscribers in Bulk](https://api.senderwiz.com/customer/subscribers/create-subscribers-in-bulk.md): Create multiple subscribers at once within a specific list using their email and any optional custom fields. Efficient for large list imports or API-driven syncs. - [Update a Subscriber](https://api.senderwiz.com/customer/subscribers/update-a-subscriber.md): Update the details of an existing subscriber in a specific list by using their unique subscriber ID. Useful for correcting or modifying stored subscriber data. - [Update a Subscriber by Email](https://api.senderwiz.com/customer/subscribers/update-a-subscriber-by-email.md): Update the details of a subscriber by searching with their email address within a specific list. This method is ideal when the subscriber UID is not known in advance. - [Create or Update a Subscriber](https://api.senderwiz.com/customer/subscribers/create-or-update-a-subscriber.md): Create a new subscriber or update an existing one in a specific list. This unified endpoint handles both creation and update operations based on the email provided. - [Unsubscribe a Subscriber](https://api.senderwiz.com/customer/subscribers/unsubscribe-a-subscriber.md): Silently unsubscribe a subscriber from a list using their unique subscriber and list identifiers. No notification email is sent. - [Unsubscribe a Subscriber by Email](https://api.senderwiz.com/customer/subscribers/unsubscribe-a-subscriber-by-email.md): Silently unsubscribe a subscriber from a specific list by using their email address. No email notification will be sent. - [Unsubscribe Subscriber from All Lists](https://api.senderwiz.com/customer/subscribers/unsubscribe-subscriber-from-all-lists.md): Unsubscribe a subscriber from all lists using their email address. This is a silent operation — no confirmation email is sent. - [Delete One Subscriber](https://api.senderwiz.com/customer/subscribers/delete-one-subscriber.md): Permanently delete a subscriber from a specific list. This operation is silent — no notification email will be sent. - [Delete Subscriber by Email](https://api.senderwiz.com/customer/subscribers/delete-subscriber-by-email.md): Delete a subscriber from a list using their email address. This is a silent operation — no email will be sent to the user. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://api.senderwiz.com/customer/subscribers.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.