Skip to content
Finowl

Email breach checks · Media and publishing

Email breach checks for subscription publishers

Subscription publishers see the same pattern again and again: an account suddenly logs in from many locations, the email address changes, and the real reader writes in confused. Checking subscriber emails against Finowl Intelligence helps you spot accounts at elevated risk before that happens. The response shows each breach, its date and which data classes leaked, so you can focus on accounts where passwords were exposed.

Publishers can use the signal without adding friction for everyone. Ask for a one-time code when a subscriber with a breached address changes their email or payment method, or when concurrent sessions spike. Audience and customer care teams can use the same data to explain why a reader was asked to verify, which protects trust in a relationship that depends on renewals.

USE CASES

Where it fits in media and publishing

HOW TO INTEGRATE

The workflow

  1. 1

    Store FINOWL_API_KEY on the subscription backend and keep it out of paywall scripts and client code.

  2. 2

    Call POST /v1/breaches/email at registration and before changes to email, password or payment method.

  3. 3

    Evaluate breached, DataClasses and IsVerified to decide whether to request a one-time code.

  4. 4

    Feed the result into your session-sharing rules alongside device and concurrency signals.

  5. 5

    Cache results for a short period and retry 429 responses only after the Retry-After interval.

POST /v1/breaches/email
curl https://api.finowl.co/v1/breaches/email \
  -H "Authorization: Bearer $FINOWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "morning.reader@example.com"
}'

Runs before a subscriber changes their payment method. If the address appears in a breach that exposed passwords, send a one-time code to the current email first.

GOOD PRACTICE

Before you ship

Read the API reference for every field and error code. Each lookup costs 1 credit; see pricing.

A FEW GOOD QUESTIONS

Common questions

Email breach checks for subscription publishers

Start with 100 free credits every month and test the request above in the sandbox.