FadSync LogoFadSync
Sign InGet API Key

FadSync API Reference

RapidAPI Verified

Integrate sub-100ms disposable email detection into your stack using our RapidAPI gateway. Protect your database from temporary address spam with real-time validation.

Authentication

FadSync utilizes RapidAPI for authentication. All requests must include the following headers:

HeaderValue
X-RapidAPI-KeyYOUR_RAPIDAPI_KEY
X-RapidAPI-Hostfadsync-email-validation.p.rapidapi.com

Quickstart

To get started immediately, sign up for a free tier on our RapidAPI hub. Once you have your YOUR_RAPIDAPI_KEY, you can make your first request to the /v1/check endpoint.

A typical integration involves passing the user's email input from your frontend directly to your backend, and then making a server-to-server request to FadSync to determine if the email should be allowed to register.

POST

/v1/check

Analyze an email address to determine if it is associated with a disposable email provider, has a valid MX record, or is considered "high risk" in real-time.

Body Parameters

emailstring
required

The email address to be validated. e.g., [email protected].

Response Body

200 OK
{
  "email": "[email protected]",
  "is_valid_format": true,
  "is_disposable": true,
  "is_free_provider": false,
  "is_role_account": false,
  "has_valid_mx": true,
  "provider": "TrashMail",
  "risk_score": 100,
  "recommendation": "BLOCK"
}
curl --request POST \
  --url https://fadsync-email-validation.p.rapidapi.com/v1/check \
  --header 'Content-Type: application/json' \
  --header 'X-RapidAPI-Host: fadsync-email-validation.p.rapidapi.com' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --data '{"email": "[email protected]"}'
POST

/v1/bulk

Submit an array of email addresses to validate them in a single batch. Ideal for cleaning existing databases or handling large CSV uploads efficiently.

Body Parameters

emailsarray[string]
required

An array of email addresses to validate. Maximum 1000 emails per request. e.g., ["[email protected]", "[email protected]"].

Response Body

200 OK
{
  "results": [
    {
      "email": "[email protected]",
      "recommendation": "ALLOW"
    },
    {
      "email": "[email protected]",
      "recommendation": "BLOCK"
    }
  ]
}
curl --request POST \
  --url https://fadsync-email-validation.p.rapidapi.com/v1/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-RapidAPI-Host: fadsync-email-validation.p.rapidapi.com' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --data '{"emails": ["[email protected]", "[email protected]"]}'
GET

/v1/domain

Analyze an entire domain to retrieve MX records, disposable status, and catch-all configuration without checking a specific inbox.

Query Parameters

domainstring
required

The domain to analyze. e.g., trashmail.com.

Response Body

200 OK
{
  "domain": "trashmail.com",
  "is_disposable": true,
  "has_mx": true,
  "is_catch_all": true,
  "mx_records": [
    "mx.trashmail.com"
  ],
  "risk_score": 100
}
curl --request GET \
  --url 'https://fadsync-email-validation.p.rapidapi.com/v1/domain?domain=trashmail.com' \
  --header 'X-RapidAPI-Host: fadsync-email-validation.p.rapidapi.com' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

SDKs & Libraries

FadSync can be integrated into almost any tech stack. Use the installation commands and reference code below to quickly plug FadSync into your backend architecture.

Node.js

Perfect for Express.js, NestJS, and Next.js backends. Utilize axios or native fetch.

$ npm install axios
index.js
const axios = require('axios');

const options = {
  method: 'POST',
  url: 'https://fadsync-email-validation.p.rapidapi.com/v1/check',
  headers: {
    'content-type': 'application/json',
    'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY',
    'X-RapidAPI-Host': 'fadsync-email-validation.p.rapidapi.com'
  },
  data: { email: '[email protected]' }
};

try {
    const response = await axios.request(options);
    console.log(response.data);
} catch (error) {
    console.error(error);
}

Python

Ideal for Django and Flask. Use the highly popular requests module for rapid integrations.

$ pip install requests
main.py
import requests

url = "https://fadsync-email-validation.p.rapidapi.com/v1/check"
payload = { "email": "[email protected]" }
headers = {
    "content-type": "application/json",
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "fadsync-email-validation.p.rapidapi.com"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

cURL

Use cURL for quick bash scripting, CRON jobs, and raw terminal testing.

# Natively installed on most Unix systems
Terminal
curl --request POST \
  --url https://fadsync-email-validation.p.rapidapi.com/v1/check \
  --header 'Content-Type: application/json' \
  --header 'X-RapidAPI-Host: fadsync-email-validation.p.rapidapi.com' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --data '{"email": "[email protected]"}'

PHP

Great for Laravel, WordPress plugins, and legacy native PHP systems using curl_init().

# Requires php-curl extension
app.php
<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://fadsync-email-validation.p.rapidapi.com/v1/check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode(['email' => '[email protected]']),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-RapidAPI-Host: fadsync-email-validation.p.rapidapi.com",
    "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;