> 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/es/docs/email-verify

# Verificación de correo electrónico

API de DomScan: Comprueba si las direcciones de correo electrónico son reales y entregables.

Comprueba si las direcciones de correo electrónico son reales y entregables. Reduce las tasas de rechazo, protege tu reputación de remitente y mejora la entregabilidad.

**Precios:** Comprobación básica (2 créditos) · Sintaxis, MX, desechable, basado en roles

GET /v1/email/verify

#### Parámetros de consulta

| Parámetro | Tipo | Descripción |
| --- | --- | --- |
| email obligatorio | string | Verifica si las direcciones de correo electrónico son reales y entregables |
| full opcional | boolean Predeterminado `false` | Obsoleto y ya no cambia el resultado. La verificación de buzón SMTP se ha retirado, por lo que la respuesta es idéntica con o sin él y el coste permanece igual. |

#### Precios

| Nivel | Coste | Comprobaciones incluidas |
| --- | --- | --- |
| Comprobación básica | 2 créditos | Sintaxis, MX, desechable, basado en roles |

#### Solicitud de ejemplo

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

#### Respuesta de ejemplo

```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
}
```

#### Campos de respuesta

| Campo | Tipo |
| --- | --- |
| `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

#### Cuerpo de la solicitud

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

Verifica hasta 100 correos electrónicos en una única solicitud de API.

#### Solicitud de ejemplo

```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"]
  }'
```

#### Respuesta de ejemplo

```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
}
```

#### Campos de respuesta

| Campo | Tipo |
| --- | --- |
| `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 |
