> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dojah.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Email Check API: Deliverability and Fraud Risk

> Submit an email address to receive a risk profile including reputation, breach exposure, disposable-email detection, domain analysis, and deliverability signals.

```http [GET] theme={null}
{{baseUrl}}/api/v1/fraud/email
```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| Authorization | string | Private/secret key. Use `<key>` not `Bearer <key>`                                                  |

### Query parameter

| Parameter      | Type   | Description   | Required |
| -------------- | ------ | ------------- | -------- |
| email\_address | string | email of user | required |

### Sample response

```json Response theme={null}
{
  "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"
      ]
    }
  }
}
```

### Response Fields

| Field                                        | Type    | Description                                                                  |
| -------------------------------------------- | ------- | ---------------------------------------------------------------------------- |
| entity                                       | object  | Contains the email risk profile data                                         |
| entity.email                                 | string  | The email address that was screened                                          |
| entity.reputation                            | string  | Overall email reputation rating (e.g., "high", "medium", "low")              |
| entity.suspicious                            | boolean | `true` if the email is flagged as suspicious based on combined risk signals  |
| entity.references                            | integer | Number of online references or appearances found for this email              |
| entity.details                               | object  | Detailed breakdown of email risk signals                                     |
| entity.details.blacklisted                   | boolean | `true` if the email appears on known blacklists                              |
| entity.details.malicious\_activity           | boolean | `true` if the email has been associated with malicious activity              |
| entity.details.malicious\_activity\_recent   | boolean | `true` if malicious activity was detected recently                           |
| entity.details.credentials\_leaked           | boolean | `true` if the email's credentials have appeared in known data leaks          |
| entity.details.credentials\_leaked\_recent   | boolean | `true` if credential leaks were detected recently                            |
| entity.details.data\_breach                  | boolean | `true` if the email was found in known data breaches                         |
| entity.details.first\_seen                   | string  | Date the email was first observed online (MM/DD/YYYY)                        |
| entity.details.last\_seen                    | string  | Date the email was last observed online (MM/DD/YYYY)                         |
| entity.details.domain\_exists                | boolean | `true` if the email's domain exists and resolves                             |
| entity.details.domain\_reputation            | string  | Reputation score of the email's domain, or "n/a" if unavailable              |
| entity.details.new\_domain                   | boolean | `true` if the domain was recently created, which can indicate fraud          |
| entity.details.days\_since\_domain\_creation | integer | Number of days since the email domain was registered                         |
| entity.details.suspicious\_tld               | boolean | `true` if the domain uses a top-level domain commonly associated with abuse  |
| entity.details.spam                          | boolean | `true` if the email has been associated with spam activity                   |
| entity.details.free\_provider                | boolean | `true` if the email is from a free provider (e.g., Gmail, Yahoo)             |
| entity.details.disposable                    | boolean | `true` if the email belongs to a disposable or temporary email service       |
| entity.details.deliverable                   | boolean | `true` if the email address can receive messages                             |
| entity.details.accept\_all                   | boolean | `true` if the mail server accepts all incoming emails regardless of address  |
| entity.details.valid\_mx                     | boolean | `true` if the domain has valid MX (mail exchange) records                    |
| entity.details.primary\_mx                   | string  | Primary mail exchange server hostname for the domain                         |
| entity.details.spoofable                     | boolean | `true` if the domain can be spoofed due to lacking anti-spoofing protections |
| entity.details.spf\_strict                   | boolean | `true` if the domain has strict SPF (Sender Policy Framework) records        |
| entity.details.dmarc\_enforced               | boolean | `true` if the domain enforces DMARC authentication                           |
| entity.details.profiles                      | array   | List of online platforms where the email address has registered accounts     |

### Test Credentials for Sandbox

Kindly use this Test Email in sandbox Environment

Email Address = `johndoe@gmail.com`
