Email Check - Dojah Inc

curl --request GET \
  "https://api.dojah.io/api/v1/fraud/email?email_address=johndoe%40gmail.com" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}"

const params = new URLSearchParams({
  "email_address": "johndoe@gmail.com",
});

const url = "https://api.dojah.io/api/v1/fraud/email?" + params;
const res = await fetch(url, {
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    AppId: process.env.DOJAH_APP_ID,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.dojah.io/api/v1/fraud/email",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "AppId": os.environ["DOJAH_APP_ID"],
    },
    params={
        "email_address": "johndoe@gmail.com",
    },
)
data = res.json()

{
  "entity": {
    "email": "johndoe@gmail.com",
    "reputation": "high",
    "suspicious": false,
    "references": 178,
    "details": {
      "blacklisted": false,
      "malicious_activity": false,
      "malicious_activity_recent": false,
      "credentials_leaked": true,
      "credentials_leaked_recent": false,
      "data_breach": true,
      "first_seen": "07/01/2008",
      "last_seen": "03/22/2021",
      "domain_exists": true,
      "domain_reputation": "n/a",
      "new_domain": false,
      "days_since_domain_creation": 9474,
      "suspicious_tld": false,
      "spam": false,
      "free_provider": true,
      "disposable": false,
      "deliverable": true,
      "accept_all": false,
      "valid_mx": true,
      "primary_mx": "gmail-smtp-in.l.google.com",
      "spoofable": true,
      "spf_strict": true,
      "dmarc_enforced": false,
      "profiles": [
        "aboutme",
        "flickr",
        "angellist",
        "foursquare",
        "myspace",
        "twitter",
        "vimeo",
        "linkedin"
      ]
    }
  }
}

GET/api/v1/fraud/email

Submit an email address and get back a risk profile: reputation, breach exposure, disposable-email detection, domain analysis and deliverability signals.

Headers

Header	Required	Description
`Authorization`	Yes	Your app’s secret key, sent as-is — not `Bearer`.
`AppId`	Yes	The App ID from your dashboard.

Query parameters

Parameter	Type	Required	Description
`email_address`	string	Yes	The email address to screen.

Response

Returns an entity with an overall reputation, a suspicious flag, the number of references seen, and a details object covering blacklisting, breach and credential-leak history, domain age, disposable/free-provider detection, deliverability and the social profiles the address is linked to.

Errors

Code	Meaning
`400`	Bad request — a required parameter is missing or malformed.
`401`	Unauthorized — check your key and `AppId` (no `Bearer` prefix).
`402`	Insufficient wallet balance. Fund your wallet.
`404`	No record found for the supplied identifier.
`429`	Too many requests — back off and retry.

Sandbox

Test with email_address=johndoe@gmail.com against https://sandbox.dojah.io. See Sandbox & test data for every test value.

curl --request GET \
  "https://api.dojah.io/api/v1/fraud/email?email_address=johndoe%40gmail.com" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}"

const params = new URLSearchParams({
  "email_address": "johndoe@gmail.com",
});

const url = "https://api.dojah.io/api/v1/fraud/email?" + params;
const res = await fetch(url, {
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    AppId: process.env.DOJAH_APP_ID,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.dojah.io/api/v1/fraud/email",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "AppId": os.environ["DOJAH_APP_ID"],
    },
    params={
        "email_address": "johndoe@gmail.com",
    },
)
data = res.json()

{
  "entity": {
    "email": "johndoe@gmail.com",
    "reputation": "high",
    "suspicious": false,
    "references": 178,
    "details": {
      "blacklisted": false,
      "malicious_activity": false,
      "malicious_activity_recent": false,
      "credentials_leaked": true,
      "credentials_leaked_recent": false,
      "data_breach": true,
      "first_seen": "07/01/2008",
      "last_seen": "03/22/2021",
      "domain_exists": true,
      "domain_reputation": "n/a",
      "new_domain": false,
      "days_since_domain_creation": 9474,
      "suspicious_tld": false,
      "spam": false,
      "free_provider": true,
      "disposable": false,
      "deliverable": true,
      "accept_all": false,
      "valid_mx": true,
      "primary_mx": "gmail-smtp-in.l.google.com",
      "spoofable": true,
      "spf_strict": true,
      "dmarc_enforced": false,
      "profiles": [
        "aboutme",
        "flickr",
        "angellist",
        "foursquare",
        "myspace",
        "twitter",
        "vimeo",
        "linkedin"
      ]
    }
  }
}