Fidro + Python Integration

Overview

To integrate Fidro with Python, use the requests library to send a POST request to the Fidro API with the user's email and IP address. Fidro combines email validation, disposable email detection, IP geolocation, and fraud scoring into a single API call that returns a JSON response. No SDK is needed — Python's requests library is all you need to get started.

Fidro is a fraud detection API that combines email validation, IP intelligence, geolocation analysis, and Stripe chargeback prevention in a single API call. It returns a risk score with a clear recommendation — allow, review, or block — so you can stop fraud without building your own scoring logic.

2. Email Validation

Send a POST request to Fidro's /v1/validate endpoint with the user's email address and optional IP. Fidro validates the email, checks for disposable domains, analyzes the IP for VPN/proxy/Tor usage, and returns a risk score with a clear recommendation — allow, review, or block.

import os
import requests

FIDRO_API_KEY = os.environ["FIDRO_API_KEY"]

def validate_email(email: str, ip: str) -> dict:
    response = requests.post(
        "https://api.fidro.io/v1/validate",
        headers={
            "Authorization": f"Bearer {FIDRO_API_KEY}",
            "Content-Type": "application/json",
        },
        json={"email": email, "ip": ip},
    )
    response.raise_for_status()
    result = response.json()

    print(f"Risk score: {result['data']['risk_score']}")
    print(f"Recommendation: {result['data']['recommendation']}")
    return result

# Usage
result = validate_email("test@example.com", "8.8.8.8")
print(result)