benecaster_get_subscriber_data()

Looks up a subscriber’s Benecaster state for one show, starting from their email address. Built for integrations whose own data — a CRM export, a webhook payload, a CSV — is keyed by email rather than by WordPress user ID.

Benecaster subscribers are WordPress users; there is no subscriber record that exists independently of the WP user. This is a convenience layer over that lookup plus the existing public functions, so one call replaces three.

null and “no access” are different answers, and conflating them loses information. null means no WordPress user holds that address. A user who exists but has never had a token for this show comes back as an array with token_status of 'none' and an empty tier — that is somebody with an account who simply is not subscribed here, which usually deserves different handling from a stranger.