E-mail validatie API-documenten

Aan de slag

Alle API-verzoeken vereisen authenticatie met behulp van een API-sleutel. Je kunt je API-sleutel vinden in het dashboard.

Koptekst: "x-api-key: uw-api-key".

Enkelvoudige verificatie

Controleer een e-mailadres of domein op geldigheid, wegwerpstatus, privacyservices en deliverability.

Eindpunt

GET /v1/verify

Parameters

Naam	Type	Vereist	Beschrijving
input	string	Ja	E-mailadres of domein om te verifiëren (bijv. [email protected] of example.com)

Responsevelden

Veld	Beschrijving
valid	Geeft aan of de e-mailopmaak correct is
block	Geeft aan of de e-mail moet worden geblokkeerd (true als disposable, privacy, applePrivateEmail, deliverable of catch_all waar is)
disposable	Bepaalt of het e-mailadres een tijdelijk of wegwerp e-mailadres is
privacy	Bepaalt of de mailserver een e-mailalias of -forwarder gebruikt
applePrivateEmail	Geeft aan of de e-mail een privé-e-mailadres van Apple is
deliverable	Controleert of de mailbox bestaat en e-mails kan ontvangen
domain	Het domeingedeelte van het e-mailadres
email_address	Het e-mailadres
catch_all	Geeft aan of het domein een catch-all e-mailconfiguratie heeft die alle inkomende e-mails accepteert, ongeacht het ontvangstadres
mx_found	Geeft aan of het domein geldige mailservers (MX records) heeft.
remaining_credits	Het aantal API credits dat nog op je account staat

Zwarte lijst / witte lijst: Alleen het blokveld geeft het lidmaatschap van de lijst weer. Zwarte lijst → blokkeren: waar; witte lijst → blokkeren: onwaar; niet in witte lijst (indien ingeschakeld) → blokkeren: waar. Gebruik geldig niet om te beslissen of je blokkeert op basis van lijsten.

Voorbeeld Response

{
  "valid": true,
  "block": false,
  "disposable": false,
  "privacy": false,
  "applePrivateEmail": false,
  "deliverable": true,
  "domain": "example.com",
  "email_address": "[email protected]",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Code-voorbeelden

curl "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

Probeer het uit

API-sleutel

U hebt een API-sleutel nodig om de eindpunten te testen.

E-mailadres of domein

Probeer met:

Batchverificatie

Verifieer meerdere e-mailadressen of domeinen in één aanvraag (max. 100 items).

Eindpunt

POST /v1/verify/batch

Parameters

Naam	Type	Vereist	Beschrijving
inputs	array of strings	Ja	Reeks e-mailadressen of domeinen om te verifiëren

Code-voorbeelden

curl -X POST "https://api.verify-email.app/v1/verify/batch" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "inputs": [
      "[email protected]",
      "[email protected]"
    ]
  }'

Probeer het uit

API-sleutel

U hebt een API-sleutel nodig om de eindpunten te testen.

E-mailadressen of domeinen

Probeer het met verschillende domeinen:

Alleen te leveren controle

Snelle controle op e-mail deliverability met MX- en SMTP-verificatie zonder externe API-aanroepen. Retourneert alleen deliverability-gerelateerde velden voor snellere responstijden.

Eindpunt

GET /v1/verify/deliverable

Parameters

Naam	Type	Vereist	Beschrijving
input	string	Ja	E-mailadres om de bezorgbaarheid te controleren (bijv. [email protected]). Domein-alleen invoer wordt niet ondersteund voor dit eindpunt.

Responsevelden

Veld	Beschrijving
valid	Geeft aan of de e-mailopmaak correct is
deliverable	Controleert of de mailbox bestaat en e-mails kan ontvangen
mx_found	Geeft aan of het domein geldige mailservers (MX records) heeft.
catch_all	Geeft aan of het domein een catch-all e-mailconfiguratie heeft die alle inkomende e-mails accepteert, ongeacht het ontvangstadres
email_address	Het e-mailadres
remaining_credits	Het aantal API credits dat nog op je account staat

Voorbeeld Response

{
  "valid": true,
  "deliverable": true,
  "mx_found": true,
  "catch_all": false,
  "email_address": "[email protected]",
  "remaining_credits": 99
}

Code-voorbeelden

curl "https://api.verify-email.app/v1/verify/[email protected]" \
  -H "X-API-Key: your-api-key"

Probeer het uit

API-sleutel

U hebt een API-sleutel nodig om de eindpunten te testen.

E-mailadres of domein

Probeer met:

Whitelist en blacklist

Bepaal welke e-mails en domeinen worden geblokkeerd met per-gebruiker blacklist- en whitelistregels. Deze lijsten bepalen het block-veld in elk verificatieantwoord.

{}

Het block-veld

Elk verificatieantwoord bevat een block-veld. Gebruik dit veld om te bepalen of de e-mail/domein geblokkeerd moet worden op basis van je lijsten:

trueE-mail of het domein staat op de blacklist → block: true. Een domein toevoegen blokkeert alle e-mails op dat domein.

trueWhitelist is actief maar de e-mail/domein staat er niet op → block: true.

falseWhitelist is actief en de e-mail of het domein staat erop → block: false.

—Geen van de lijsten is van toepassing → block volgt het normale verificatieresultaat.

Overzicht

✘

Blacklist

Blokkeer altijd specifieke e-mails of hele domeinen. Bijvoorbeeld: example.com aan de blacklist toevoegen betekent dat elke e-mail @example.com block: true teruggeeft, ongeacht het verificatieresultaat.

✔

Whitelist

Sta alleen specifieke e-mails of domeinen toe. Met whitelist actief krijgen alleen vermeldingen op de lijst block: false; al het andere block: true. Bijvoorbeeld: gmail.com toevoegen staat elke @gmail.com toe, maar [email protected] wordt geblokkeerd. Uitgeschakeld heeft de whitelist geen effect.

Je kunt een volledig e-mailadres ([email protected]) of een domein (example.com) toevoegen. Een domein toevoegen geldt voor elke e-mail op dat domein. Hoofdletters maken niet uit.

Hoe het werkt

Volgorde van beoordeling

Eerst blacklist — Als het e-mailadres of het domein op de blacklist staat, is het resultaat block: true. Verdere lijstlogica wordt niet toegepast.

Whitelist (indien actief) — Als e-mail/domein op de whitelist staat → block: false. Zo niet → block: true.

Whitelist uitgeschakeld — Alleen de blacklist en normale verificatie zijn van toepassing.

De blacklist heeft altijd voorrang: een adres op de blacklist blijft geblokkeerd ook als het op de whitelist staat.

Wat wordt gecontroleerd

E-mailverificatie — de API controleert het volledige adres en het domein tegen beide lijsten. Een overeenkomst past de lijstregel toe.

Domeinverificatie — alleen het domein wordt gecontroleerd tegen de blacklist en (indien actief) de whitelist.

Snelle referentie

Whitelist actief	Op blacklist	Op whitelist	block-waarde
Nee	Ja	—	`true`
Nee	Nee	—	Normaal
Ja	Ja	Elke	`true`
Ja	Nee	Ja	`false`
Ja	Nee	Nee	`true`

API-endpoints voor lijsten

Alle lijst-endpoints vereisen de header: X-API-Key: your-api-key

Blacklist

GET/v1/blacklist

Alle blacklist-vermeldingen tonen

POST/v1/blacklist

E-mail of domein toevoegen · { "value": "..." }

DELETE/v1/blacklist

Vermelding verwijderen · value=...

Whitelist

GET/v1/whitelist

Alle whitelist-vermeldingen tonen

POST/v1/whitelist

E-mail of domein toevoegen · { "value": "..." }

DELETE/v1/whitelist

Vermelding verwijderen · value=...

GET/v1/whitelist/enabled

Whitelist-status ophalen · { "enabled": boolean }

PUT/v1/whitelist/enabled

Whitelist aan/uit zetten · { "enabled": true | false }

Code-voorbeelden (cURL)

✘

Blacklist

GET/v1/blacklist

Alle blacklist-vermeldingen tonen

curl "https://api.verify-email.app/v1/blacklist" \
  -H "X-API-Key: your-api-key"

POST/v1/blacklist

E-mail of domein toevoegen

curl -X POST "https://api.verify-email.app/v1/blacklist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/blacklist

Vermelding verwijderen

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

✔

Whitelist

GET/v1/whitelist

Alle whitelist-vermeldingen tonen

curl "https://api.verify-email.app/v1/whitelist" \
  -H "X-API-Key: your-api-key"

POST/v1/whitelist

E-mail of domein toevoegen

curl -X POST "https://api.verify-email.app/v1/whitelist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/whitelist

Vermelding verwijderen

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

GET/v1/whitelist/enabled

Whitelist-status ophalen

curl "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "X-API-Key: your-api-key"

PUT/v1/whitelist/enabled

Whitelist aan/uit zetten

curl -X PUT "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "enabled": true
  }'

Waardeformaat

[email protected] — E-mail: geldig formaat, bijv. [email protected]
example.com — Domein: geldig formaat, bijv. example.com

Ongeldige waarden worden met 400 geweigerd. Vermeldingen worden genormaliseerd opgeslagen. Duplicaten worden samengevoegd tot één vermelding.

Waar lijsten worden toegepast

Lijstregels worden na verificatie toegepast. Enkelvoudige en batch e-mailverificatie en domeinverificatie bevatten al de blacklist en whitelist van de gebruiker in het block-veld.

MCP-server (AI Agent-integratie)

Integreer e-mailverificatie rechtstreeks in AI-agents zoals Cursor en Claude Desktop met behulp van het Model Context Protocol (MCP). Je AI-assistent kan e-mails verifiëren, domeinen controleren en syntaxis valideren zonder de editor te verlaten.

Docs endpoint for AI agents

The API exposes a machine-readable docs endpoint (no API key required) so AI agents and MCP clients can discover the server, available tools, and auth requirements. Use this URL in your agent or MCP configuration.

GET /v1/mcp/docs

Returns JSON with server name, description, serverUrl, docsEndpoint, authentication details, and full tool definitions.

curl "https://api.verify-email.app/v1/mcp/docs"

AI agents can GET this URL to receive server metadata, tool schemas, and integration instructions in JSON. No authentication is required for the docs endpoint.

Open docs endpoint How to add in Cursor How to add in Claude

Integration details

Authentication

All MCP tool calls require your API key in the X-API-Key header. Get your key from the dashboard.

MCP server URL: https://api.verify-email.app/mcp

Docs endpoint (for agents): https://api.verify-email.app/v1/mcp/docs

Cursor

Add the server in Cursor Settings → Tools & MCP, or add the config to .cursor/mcp.json in your project or home directory.

Claude Desktop

Add the server to your Claude Desktop config (mcpServers in claude_desktop_config.json). Use the server URL and X-API-Key header as shown below.

Response format

Tool results match the REST API response shape (valid, block, deliverable, remaining_credits, etc.). Use the block field for blacklist/whitelist decisions.

This MCP server is production-ready and uses the same API as the REST endpoints. Credits are consumed per verification as with the REST API.

Setup

Voeg de volgende configuratie toe aan je .cursor/mcp.json of Claude Desktop config bestand:

{
  "mcpServers": {
    "email-checker": {
      "url": "https://api.verify-email.app/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Beschikbare gereedschappen

Gereedschap	Beschrijving	Invoer	Credits
verify_email	Volledige e-mailverificatie inclusief controles op syntaxis, MX, SMTP, wegwerp, privacy en deliverability	{ email: string }	1
verify_domain	Volledige domeinverificatie inclusief MX-records, wegwerp-, privacy- en catch-all-detectie	{ domain: string }	1
check_deliverability	Snelle controle op deliverability met MX- en SMTP-verificatie zonder externe API-aanroepen	{ email: string }	1
verify_batch	Batchverificatie voor maximaal 100 e-mails of domeinen in één verzoek	{ inputs: string[] }	1 per item
validate_email_syntax	Snelle lokale syntaxisvalidatie tegen RFC 5322 zonder netwerkgesprekken	{ email: string }	0 (free)