Skip to content

SDK method

tools.listSubscribers

List subscribers. Convenience alias for list_subscribers, forwarding to tinbox.api.members.list.query.

Signature

ts
listSubscribers(input: Parameters<TinboxTools["listSubscribers"]>[0]): ReturnType<TinboxTools["listSubscribers"]>

Parameters

NameTypeRequiredDescription
audienceIdstringyesThe audience id.
status"subscribed" | "unsubscribed" | "pending" | "cleaned" | "transactional"noFilter by subscription status.
tagstringnoFilter by tag name.
searchstringnoSearch by email or name.
limitnumbernoMax results (default 50, max 200).

Returns

ReturnType<TinboxTools["listSubscribers"]>

Example

ts
await tinbox.tools.listSubscribers({
  "audienceId": "aud_…"
});