feat(receiving): filter listed received emails by recipient and date

IS
5h ago
+52-3

Adds the to, startDate and endDate filters from GET /emails/receiving to resend.emails.receiving.list(), so users can list the emails an address received without going through threads.

await resend.emails.receiving.list({
  to: ['support@acme.com'], // up to 20, exact case-sensitive match
  startDate: '2026-11-01',
  endDate: '2026-11-15',
});
  • Option names and shape match inboxes.threads.search (to: string[], camelCase dates), and the URL is built with the same buildInboxCursorUrl helper, which joins to into one comma-separated param as the API expects (repeating to returns a 422).
  • Pagination (limit / after / before) is unchanged.

API: resend/resend-monorepo#13763 (filters, behind the api-filtering team flag) and resend/resend-monorepo#14432 (index-backed to match). Until the flag is on for a team, the API ignores these params.

Linear: MES-2800


Summary by cubic

Adds to, startDate, and endDate filters to resend.emails.receiving.list() so users can list the emails an address received without going through threads.

  • Option names and shape match inboxes.threads.search (to: string[], camelCase dates).
  • The URL is built with the same buildInboxCursorUrl helper, which joins to into one comma-separated param as the API expects; repeating to returns a 422.
  • Pagination (limit, after, before) is unchanged.
  • The API ignores these params until the api-filtering team flag is enabled.