Veille

Domain Validation

GET
/v1/intelligence/domain

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.

Credit cost: 2 credits per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

The domain to validate. Accepts raw domains (tempmail.org), full URLs (https://www.tempmail.org/page), or domains with www. prefix, all are normalized automatically.

certificate_transparency?boolean

Enable Certificate Transparency lookup. Returns SSL/TLS certificate history, current certificate, issuers, and all Subject Alternative Names (SANs) ever associated with the domain. Adds 1-5 seconds of latency.

Defaultfalse
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
dns?
tags?array<string>
whois?
domain?string
sources?array<string>
education?boolean
last_seen?string
disposable?boolean
first_seen?string
is_subdomain?boolean
relay_domain?boolean
public_domain?boolean
domain_age_days?integer
Example Request
curl -X GET 'https://api.veille.io/v1/intelligence/domain?query=string'
Example Response
{  "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}