GoodSender icon

GoodSender

Send transactional, custom, and consent emails through GoodSender

Email → List Consents

AI-generated

Summary

Lists recipient consent statuses for a sender domain via GET /v1/emails on the GoodSender API, with optional filtering and cursor pagination.

Inputs

  • domain (required) — Sender domain to list consent statuses for. Sent as the domain query parameter.
  • filters.limit — Maximum number of results to return (minimum 1; UI default 50). Sent as limit.
  • filters.cursor — Pagination cursor, taken as nextCursor from a previous call. Sent as cursor.
  • filters.consentStatus — Filter by consent status: denied, failed, granted, pending, or requested. Only sent if you add this filter.
  • filters.engagementStatus — Filter by engagement status: cooling, dormant, hot, inactive, new, or warm. Only sent if you add this filter.
  • requestOptions — Node settings for batching (items per batch, interval), ignoring SSL issues, proxy, and request timeout (default 10000 ms).

Output shape

The JSON response from GoodSender's GET /v1/emails endpoint, containing the recipient consent records for the domain.

The exact response fields aren't defined in the node source. The Cursor description implies the response includes a nextCursor field. The node does not auto-paginate, so for more results pass nextCursor back as the Cursor filter. Once you add a filter, the Consent Status and Engagement Status options pre-select 'granted' and 'new' by default, so remove filters you don't want applied.

Examples

Example 1: Get all recipients who have granted consent for your domain

Domain = your-domain.com; Filters: Consent Status = Granted, Limit = 100.

Example 2: Page through all pending consent requests

Domain = your-domain.com; Filters: Consent Status = Pending; on follow-up calls set Cursor to the previous response's nextCursor.

Example 3: Find highly engaged recipients to target

Domain = your-domain.com; Filters: Engagement Status = Hot.

Links

Discussion