Search sponsorship preview options
Returns donor-to-recipient sponsorship options that can be used to preview shortcode output for an automated email template. Admin users call this from the template editor; results are scoped to programs attached to the email set and filtered by the authenticated client. Requires the admin API auth middleware and user permission checks.
Authorizations
Passport bearer token authentication for legacy admin sessions.
Path Parameters
Email set ID whose linked programs determine which sponsorships can be searched for preview data.
Template trigger being previewed, such as pay_receipt or recip_email; the controller uses it to keep the route aligned with the template editor context.
Query Parameters
Optional search term. Matches donor names, recipient title fields, commitment IDs, and donor-entity IDs; validation rule: nullable|string|max:255.
255Maximum number of options to return. Validation rule: nullable|integer|min:1|max:50; defaults to 20 in this search endpoint.
1 <= x <= 50Response
Matching sponsorship preview options.
Option rows formatted for the template preview selector.