Actions36
- Automation Actions
- Campaign Actions
- Email List Actions
- Subscriber Actions
- Tag Actions
- Transactional Mail Actions
Subscriber → Get Many
AI-generatedSummary
Retrieve multiple subscribers from a specified Mailcoach email list with optional filters and pagination.
Inputs
- Email List ID (required) — The UUID of the email list from which to fetch subscribers.
- Filters — Optional criteria to filter subscribers by email address, subscription status (Subscribed, Unsubscribed, Unconfirmed), and/or tags (comma-separated).
- Return All — Whether to return all matching subscribers or limit the number of results.
- Limit — Maximum number of subscriber records to return if Return All is false (minimum 1, maximum 1000).
Output shape
a list of subscriber records with details provided by Mailcoach API
The operation makes a GET request to the /email-lists/:uuid/subscribers endpoint applying any provided filters. If Return All is false, results are limited by the Limit parameter; otherwise all matching subscribers are returned. Returned data includes an array of subscriber objects in the response's data property.
Examples
Example 1: Fetch up to 50 subscribed subscribers from a specific email list, filtering by tag 'premium'.
Set Email List ID to the target list UUID, Filters with Status='Subscribed' and Tags='premium', Return All=false, and Limit=50.