Fraud

Get risk information for a specific email address. The response will contain a recommended action (ALLOW, BLOCK, or CHALLENGE) and a more granular risk_score. You can also check the address_information and domain_information fields for more information about the email address and email domain.

This feature is in beta. Reach out to us here if you'd like to request early access.

post/v1/email/risk

Request

  • Base URL
    https://telemetry.stytch.com
  • Auth
    HTTP basic

Request body

email_addressstring required

The email address to check.

Response

Successful response

request_idstring required

Globally unique UUID that is returned with every API call. This value is important to log for debugging purposes; we may ask for this value to help identify a specific API call when helping you debug an issue.

action'ALLOW' | 'CHALLENGE' | 'BLOCK' required
risk_scoreinteger required

A score from 0 to 100 indicating how risky the email is. 100 is the most risky.

status_codeinteger required

The HTTP status code of the response. Stytch follows standard HTTP response status code patterns, e.g. 2XX values equate to success, 3XX values are redirects, 4XX are client errors, and 5XX are server errors.

Changes