> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/docs/email-verify

# Email Verification

DomScan API: Check whether email addresses are real and deliverable. Reduce bounce rates, protect your sender reputation, and improve deliverability.

Check whether email addresses are real and deliverable. Reduce bounce rates, protect your sender reputation, and improve deliverability.

**Pricing:** Basic check (2 credits) · Syntax, MX, disposable, role-based

GET /v1/email/verify

#### Query parameters

| Parameter | Type | Description |
| --- | --- | --- |
| email required | string | Verify if email addresses are real and deliverable |
| full optional | boolean Default `false` | Deprecated and no longer changes the result. SMTP mailbox verification was retired, so the response is identical with or without it and the cost stays the same. |

#### Pricing

| Tier | Cost | Checks included |
| --- | --- | --- |
| Basic check | 2 credits | Syntax, MX, disposable, role-based |

#### Example request

```bash
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/verify?email=user@company.com"
```

#### Example response

```json
{
  "email": "user@company.com",
  "normalized_email": "user@company.com",
  "result": "valid",
  "result_detail": "mx_verified",
  "risk": "low",
  "confidence": 0.62,
  "decision": "accept",
  "reasons": ["mx_found", "not_disposable", "mailbox_not_checked", "redundant_mx_records"],
  "verification": {
    "syntax_valid": true,
    "mx_found": true,
    "mx_records": ["mx1.company.com", "mx2.company.com"],
    "smtp_verified": null,
    "mailbox_exists": null,
    "catch_all": null,
    "full_inbox": null,
    "smtp_provider": null
  },
  "classification": {
    "disposable": false,
    "role_based": false,
    "free_provider": false,
    "provider": null
  },
  "reputation": {
    "dnsbl_listed": false,
    "threat_level": null
  },
  "quality": {
    "score": 100,
    "grade": "A",
    "flags": []
  },
  "signals": {
    "domain_profile": { "status": "pass", "reason": "clean_domain_profile" },
    "local_part": { "status": "pass", "reason": "clean_local_part" },
    "mx_redundancy": { "status": "pass", "reason": "redundant_mx_records" },
    "domain_authentication": { "status": "pass", "reason": "domain_authentication_strong" },
    "toxicity": { "status": "pass", "reason": "not_toxic" }
  },
  "recommendation": {
    "signup": "allow",
    "marketing": "send",
    "cold_outreach": "send"
  },
  "deliverability": {
    "status": "deliverable",
    "sub_status": "mx_verified",
    "safe_to_send": true,
    "is_toxic": false,
    "is_gibberish": false
  },
  "tier": "basic",
  "credits_used": 2
}
```

#### Response fields

| Field | Type |
| --- | --- |
| `email` | string |
| `normalized_email` | string |
| `result` | string |
| `result_detail` | string |
| `message` | string \| null |
| `risk` | string |
| `confidence` | number |
| `confidence_level` | string |
| `decision` | string |
| `reasons[]` | string[] |
| `verification` | object |
| `verification.syntax_valid` | boolean |
| `verification.mx_found` | boolean |
| `verification.null_mx` | boolean |
| `verification.mx_lookup_failed` | boolean |
| `verification.mx_records[]` | string[] |
| `verification.smtp_verified` | boolean \| null |
| `verification.mailbox_exists` | boolean \| null |
| `verification.catch_all` | boolean \| null |
| `verification.full_inbox` | boolean \| null |
| `verification.smtp_provider` | string \| null |
| `classification` | object |
| `classification.disposable` | boolean |
| `classification.disposable_confidence` | string \| null |
| `classification.role_based` | boolean |
| `classification.role_type` | string \| null |
| `classification.free_provider` | boolean |
| `classification.provider` | string \| null |
| `reputation` | object |
| `reputation.dnsbl_listed` | boolean |
| `reputation.dnsbl_status` | string |
| `reputation.threat_level` | string \| null |
| `quality` | object |
| `quality.score` | integer |
| `quality.grade` | string |
| `quality.flags[]` | string[] |
| `signals` | object |
| `evidence` | object |
| `evidence.mx_records[]` | string[] |
| `evidence.provider` | string \| null |
| `evidence.checked_via[]` | string[] |
| `evidence.normalized_parts` | object |
| `evidence.normalized_parts.local_part` | string |
| `evidence.normalized_parts.domain` | string |
| `evidence.normalized_parts.base_local_part` | string |
| `evidence.normalized_parts.tag` | string \| null |
| `evidence.domain_profile` | object |
| `evidence.domain_profile.tld` | string \| null |
| `evidence.domain_profile.label_count` | integer |
| `evidence.domain_profile.reserved` | boolean |
| `evidence.domain_profile.domain_literal` | boolean |
| `evidence.domain_profile.punycode` | boolean |
| `evidence.domain_profile.suspicious_reasons[]` | string[] |
| `evidence.domain_authentication` | object |
| `evidence.domain_authentication.checked` | boolean |
| `evidence.domain_authentication.status` | string |
| `evidence.domain_authentication.spf` | object |
| `evidence.domain_authentication.spf.exists` | boolean |
| `evidence.domain_authentication.spf.policy` | string |
| `evidence.domain_authentication.spf.record` | string \| null |
| `evidence.domain_authentication.dmarc` | object |
| `evidence.domain_authentication.dmarc.exists` | boolean |
| `evidence.domain_authentication.dmarc.policy` | string |
| `evidence.domain_authentication.dmarc.record` | string \| null |
| `evidence.domain_authentication.dmarc.percentage` | integer \| null |
| `evidence.domain_authentication.mta_sts` | object |
| `evidence.domain_authentication.mta_sts.exists` | boolean |
| `evidence.domain_authentication.mta_sts.record` | string \| null |
| `evidence.domain_authentication.tls_rpt` | object |
| `evidence.domain_authentication.tls_rpt.exists` | boolean |
| `evidence.domain_authentication.tls_rpt.record` | string \| null |
| `evidence.domain_authentication.issues[]` | string[] |
| `recommendation` | object |
| `recommendation.signup` | string |
| `recommendation.marketing` | string |
| `recommendation.cold_outreach` | string |
| `deliverability` | object |
| `deliverability.status` | string |
| `deliverability.sub_status` | string |
| `deliverability.safe_to_send` | boolean |
| `deliverability.mailbox_checked` | boolean |
| `deliverability.smtp_confirmed` | boolean |
| `deliverability.domain_accepts_mail` | boolean |
| `deliverability.accepts_all` | boolean \| null |
| `deliverability.is_role` | boolean |
| `deliverability.is_free_provider` | boolean |
| `deliverability.is_disposable` | boolean |
| `deliverability.is_toxic` | boolean |
| `deliverability.is_no_reply` | boolean |
| `deliverability.is_gibberish` | boolean |
| `suggestions` | object |
| `suggestions.did_you_mean` | string \| null |
| `limitations[]` | string[] |
| `tier` | string |
| `credits_used` | integer |
| `verified_at` | string |

POST /v1/email/verify/bulk

#### Request body

```json
{
  "emails": [
    "user@company.com",
    "ops@company.com",
    "bounce@tempmail.org"
  ]
}
```

Verify up to 100 emails in a single API request.

#### Example request

```bash
curl -H "X-API-Key: your-api-key" -X POST "https://domscan.net/v1/email/verify/bulk" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": ["user@company.com", "ops@company.com"]
  }'
```

#### Example response

```json
{
  "results": [
    {
      "email": "user@company.com",
      "result": "valid",
      "result_detail": "mx_verified",
      "tier": "basic",
      "credits_used": 2
    },
    {
      "email": "ops@company.com",
      "result": "valid",
      "result_detail": "role_based_address",
      "tier": "basic",
      "credits_used": 2
    }
  ],
  "summary": {
    "total": 2,
    "valid": 2,
    "invalid": 0,
    "risky": 0,
    "unknown": 0,
    "pending": 0
  },
  "credits_used": 4
}
```

#### Response fields

| Field | Type |
| --- | --- |
| `results[]` | object[] |
| `results[]` | object |
| `summary` | object |
| `summary.total` | integer |
| `summary.valid` | integer |
| `summary.invalid` | integer |
| `summary.risky` | integer |
| `summary.unknown` | integer |
| `summary.pending` | integer |
| `credits_used` | integer |
