Mailcoach icon

Mailcoach

Interact with Mailcoach API - Manage email lists, subscribers, campaigns, and transactional emails

Subscriber → Get Many

AI-generated

Summary

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.

Discussion