Skip to content
Finowl

Email breach checks · Fintech

Email breach checks for fintech signups and logins

When a customer signs in from a new device or asks to change a payout account, knowing that their email address shows up in several breaches is a useful risk signal. The Finowl email breach API returns each breach with its date and the data classes exposed, such as passwords or phone numbers, so your risk engine can weigh how likely it is that credentials were leaked alongside the address.

Fintech teams typically call the endpoint at signup, on suspicious logins and inside support tooling. A breached result should not block a customer on its own; it raises the bar. Combine it with device signals, velocity checks and multi-factor prompts, and treat a clean result as the absence of known exposure rather than proof that the account is safe.

USE CASES

Where it fits in fintech

HOW TO INTEGRATE

The workflow

  1. 1

    Create an API key in the Finowl dashboard and store it as FINOWL_API_KEY in your secrets manager.

  2. 2

    Call POST /v1/breaches/email from your authentication service when a login or payout change crosses your risk threshold.

  3. 3

    Filter the breaches array on IsVerified and on DataClasses that include Passwords to build a weighted signal.

  4. 4

    Feed the signal into your existing rules engine to decide between allowing, stepping up or queuing for review.

  5. 5

    Handle 429 responses by waiting for the Retry-After seconds, and fail open to your normal controls if Finowl is unavailable.

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": "payments.customer@example.com"
}'

Returns breached true or false plus a breaches array with dates and exposed data classes. Each lookup costs 1 credit.

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 fintech signups and logins

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