# Disposable Email Detection

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v1/intelligence/emailq` |
| **Base URL** | `https://api.veille.io` |
| **Credit Cost** | 5 credits per call |
| **Documentation** | https://www.piloterr.com/library/intelligence-emailq |

## Description

Deep email deliverability verification. Performs full Email Validation plus SMTP inbox check, catch-all detection, and returns a qualification verdict (valid, invalid, risky, disposable, unknown).

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.veille.io/register

## Example Request

```bash
curl --location --request GET 'https://api.veille.io/v1/intelligence/emailq' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Valid corporate inbox

```json
{
  "dns": {
    "mx": true,
    "spf": "v=spf1 include:spf.protection.outlook.com -all",
    "dmarc": "v=DMARC1; p=reject; rua=mailto:dmarc@airbus.com",
    "spf_valid": true,
    "mx_records": [
      {
        "hostname": "airbus-com.mail.protection.outlook.com",
        "priority": 10
      }
    ],
    "dmarc_valid": true,
    "mx_providers": [
      {
        "slug": "microsoft",
        "type": "mailbox",
        "grade": "professional"
      }
    ]
  },
  "email": "contact@airbus.com",
  "domain": "airbus.com",
  "is_alias": false,
  "education": false,
  "role_type": "contact",
  "disposable": false,
  "risk_score": 10,
  "smtp_valid": true,
  "did_you_mean": null,
  "has_gravatar": false,
  "relay_domain": false,
  "role_account": true,
  "public_domain": false,
  "qualification": "valid",
  "normalized_email": "contact@airbus.com"
}
```

### Invalid inbox (does not exist)

```json
{
  "dns": {
    "mx": true,
    "spf": "v=spf1 include:spf.protection.outlook.com -all",
    "dmarc": "v=DMARC1; p=reject; rua=mailto:dmarc@airbus.com",
    "spf_valid": true,
    "mx_records": [
      {
        "hostname": "airbus-com.mail.protection.outlook.com",
        "priority": 10
      }
    ],
    "dmarc_valid": true,
    "mx_providers": [
      {
        "slug": "microsoft",
        "type": "mailbox",
        "grade": "professional"
      }
    ]
  },
  "email": "nonexistent.user.xyz@airbus.com",
  "domain": "airbus.com",
  "is_alias": false,
  "education": false,
  "role_type": null,
  "disposable": false,
  "risk_score": 80,
  "smtp_valid": false,
  "did_you_mean": null,
  "has_gravatar": false,
  "relay_domain": false,
  "role_account": false,
  "public_domain": false,
  "qualification": "invalid",
  "normalized_email": "nonexistent.user.xyz@airbus.com"
}
```

### Disposable email (skips SMTP)

```json
{
  "dns": {
    "mx": true,
    "spf": "v=spf1 include:_spf.tempmail.org ~all",
    "dmarc": null,
    "spf_valid": true,
    "mx_records": [
      {
        "hostname": "mx1.tempmail.org",
        "priority": 10
      }
    ],
    "dmarc_valid": false,
    "mx_providers": []
  },
  "email": "user@tempmail.org",
  "domain": "tempmail.org",
  "is_alias": false,
  "education": false,
  "role_type": null,
  "disposable": true,
  "risk_score": 85,
  "smtp_valid": null,
  "did_you_mean": null,
  "has_gravatar": false,
  "relay_domain": false,
  "role_account": false,
  "public_domain": false,
  "qualification": "disposable",
  "normalized_email": "user@tempmail.org"
}
```

## Documentation

## Overview
Deep email deliverability verification. Performs full Email Validation plus SMTP inbox check, catch-all detection, and returns a qualification verdict (valid, invalid, risky, disposable, unknown).

## Quickstart
```
GET https://api.piloterr.com/v1/intelligence/emailq?query=john@example.com
```

## Main use cases
- Integrate Disposable Email Detection data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Intelligence without maintaining scrapers
- Power internal dashboards and workflow automations with live Intelligence data