# Disposable Domain Detection

## Overview

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

## Description

Check any domain instantly. Detects disposable email providers, public webmail, relay services, and education domains. Returns DNS health with MX provider detection, domain history, and optional SSL/TLS certificate transparency.

## 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/domain' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Disposable domain

```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": []
  },
  "tags": [
    "disposable"
  ],
  "whois": {
    "registrar": "Namecheap, Inc.",
    "updated_date": "2024-08-20",
    "creation_date": "2023-09-15",
    "expiration_date": "2025-09-15"
  },
  "domain": "tempmail.org",
  "sources": [
    "disposable-email-domains"
  ],
  "education": false,
  "last_seen": "2026-02-18",
  "disposable": true,
  "first_seen": "2024-03-12",
  "is_subdomain": false,
  "relay_domain": false,
  "public_domain": false,
  "domain_age_days": 892
}
```

### Legitimate corporate domain

```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"
      }
    ]
  },
  "tags": [],
  "whois": {
    "registrar": "MarkMonitor Inc.",
    "updated_date": "2024-05-10",
    "creation_date": "1996-06-14",
    "expiration_date": "2027-06-13"
  },
  "domain": "airbus.com",
  "sources": [],
  "education": false,
  "last_seen": null,
  "disposable": false,
  "first_seen": null,
  "is_subdomain": false,
  "relay_domain": false,
  "public_domain": false,
  "domain_age_days": 10482
}
```

### Public webmail domain

```json
{
  "dns": {
    "mx": true,
    "spf": "v=spf1 include:_spf.google.com ~all",
    "dmarc": "v=DMARC1; p=none; rua=mailto:mailauth-reports@google.com",
    "spf_valid": true,
    "mx_records": [
      {
        "hostname": "gmail-smtp-in.l.google.com",
        "priority": 5
      },
      {
        "hostname": "alt1.gmail-smtp-in.l.google.com",
        "priority": 10
      }
    ],
    "dmarc_valid": true,
    "mx_providers": [
      {
        "slug": "google",
        "type": "mailbox",
        "grade": "professional"
      }
    ]
  },
  "tags": [],
  "whois": {
    "registrar": "MarkMonitor Inc.",
    "updated_date": "2024-01-15",
    "creation_date": "1995-08-13",
    "expiration_date": "2026-08-12"
  },
  "domain": "gmail.com",
  "sources": [],
  "education": false,
  "last_seen": null,
  "disposable": false,
  "first_seen": null,
  "is_subdomain": false,
  "relay_domain": false,
  "public_domain": true,
  "domain_age_days": 9731
}
```

### Relay / alias domain

```json
{
  "dns": {
    "mx": true,
    "spf": "v=spf1 include:simplelogin.co ~all",
    "dmarc": "v=DMARC1; p=quarantine",
    "spf_valid": true,
    "mx_records": [
      {
        "hostname": "mx1.simplelogin.co",
        "priority": 10
      },
      {
        "hostname": "mx2.simplelogin.co",
        "priority": 20
      }
    ],
    "dmarc_valid": true,
    "mx_providers": [
      {
        "slug": "simplelogin",
        "type": "forwarding",
        "grade": "standard"
      }
    ]
  },
  "tags": [],
  "whois": {
    "registrar": "Gandi SAS",
    "updated_date": "2025-01-08",
    "creation_date": "2019-06-10",
    "expiration_date": "2026-06-10"
  },
  "domain": "simplelogin.io",
  "sources": [],
  "education": false,
  "last_seen": null,
  "disposable": false,
  "first_seen": null,
  "is_subdomain": false,
  "relay_domain": true,
  "public_domain": false,
  "domain_age_days": 2415
}
```

### Education domain

```json
{
  "dns": {
    "mx": true,
    "spf": "v=spf1 include:spf.protection.outlook.com -all",
    "dmarc": "v=DMARC1; p=reject",
    "spf_valid": true,
    "mx_records": [
      {
        "hostname": "mit-edu.mail.protection.outlook.com",
        "priority": 10
      }
    ],
    "dmarc_valid": true,
    "mx_providers": [
      {
        "slug": "microsoft",
        "type": "mailbox",
        "grade": "professional"
      }
    ]
  },
  "tags": [
    "education"
  ],
  "whois": {
    "registrar": null,
    "updated_date": "2023-07-19",
    "creation_date": "1985-05-23",
    "expiration_date": null
  },
  "domain": "mit.edu",
  "sources": [],
  "education": true,
  "last_seen": null,
  "disposable": false,
  "first_seen": null,
  "is_subdomain": false,
  "relay_domain": false,
  "public_domain": false,
  "domain_age_days": 14600
}
```

## Documentation

## Overview
Check any domain instantly. Detects disposable email providers, public webmail, relay services, and education domains. Returns DNS health with MX provider detection, domain history, and optional SSL/TLS certificate transparency.

## Quickstart
```
GET https://api.piloterr.com/v1/intelligence/domain?query=tempmail.org
```

## Main use cases
- Integrate Disposable Domain 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