API-dokument för validering av e-post

Komma igång

Alla API-förfrågningar kräver autentisering med hjälp av en API-nyckel. Du kan hitta din API-nyckel i instrumentpanelen.

Rubrik: "x-api-nyckel: din-api-nyckel"

Enkel verifiering

Verifiera en enskild e-postadress eller domän med avseende på giltighet, engångsstatus, integritetstjänster och leveransbarhet.

Slutpunkt

GET /v1/verify

Parametrar

Namn	Typ	Krävs	Beskrivning
input	string	Ja	E-postadress eller domän som ska verifieras (t.ex. [email protected] eller example.com)

Svarsfält

Fält	Beskrivning
valid	Anger om e-postformatet är korrekt
block	Anger om e-postmeddelandet ska blockeras (true om disposable, privacy, applePrivateEmail, deliverable eller catch_all är true)
disposable	Avgör om e-postadressen är en tillfällig e-postadress eller en e-postadress för engångsbruk
privacy	Avgör om e-postservern använder ett e-postalias eller en vidarebefordrare
applePrivateEmail	Anger om e-postadressen är en Apple Private-e-postadress
deliverable	Kontrollerar om brevlådan finns och kan ta emot e-post
domain	Domändelen av e-postadressen
email_address	E-postadressen
catch_all	Anger om domänen har en e-postkonfiguration som accepterar alla inkommande e-postmeddelanden oavsett mottagaradress
mx_found	Anger om domänen har giltiga e-postservrar (MX-poster)
remaining_credits	Antalet API-krediter som finns kvar på ditt konto

Svartlista / vitlista: Endast blockfältet återspeglar medlemskap i listan. Svart lista → block: true; vit lista → block: false; inte i vit lista (när aktiverad) → block: true. Använd inte valid för att avgöra om blockering ska ske baserat på listor.

Exempel på svar

{
  "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
}

Exempel på kod

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

Testa det

API-nyckel

Du behöver en API-nyckel för att testa slutpunkterna.

E-postadress eller domän

Prova med:

Batchverifiering

Verifiera flera e-postadresser eller domäner i en enda begäran (max 100 objekt).

Slutpunkt

POST /v1/verify/batch

Parametrar

Namn	Typ	Krävs	Beskrivning
inputs	array of strings	Ja	Array av e-postadresser eller domäner som ska verifieras

Exempel på kod

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

Testa det

API-nyckel

Du behöver en API-nyckel för att testa slutpunkterna.

E-postadresser eller domäner

Prova med olika domäner:

Check endast för leverans

Snabb kontroll av e-postleverans med hjälp av MX- och SMTP-verifiering utan externa API-anrop. Returnerar endast leveransrelaterade fält för snabbare svarstider.

Slutpunkt

GET /v1/verify/deliverable

Parametrar

Namn	Typ	Krävs	Beskrivning
input	string	Ja	E-postadress för att kontrollera leveransbarhet (t.ex. [email protected]). Inmatning av endast domäner stöds inte för denna slutpunkt.

Svarsfält

Fält	Beskrivning
valid	Anger om e-postformatet är korrekt
deliverable	Kontrollerar om brevlådan finns och kan ta emot e-post
mx_found	Anger om domänen har giltiga e-postservrar (MX-poster)
catch_all	Anger om domänen har en e-postkonfiguration som accepterar alla inkommande e-postmeddelanden oavsett mottagaradress
email_address	E-postadressen
remaining_credits	Antalet API-krediter som finns kvar på ditt konto

Exempel på svar

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

Exempel på kod

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

Testa det

API-nyckel

Du behöver en API-nyckel för att testa slutpunkterna.

E-postadress eller domän

Prova med:

Vitlista och svartlista

Styr vilka e-postadresser och domäner som blockeras med användarspecifika regler för svartlista och vitlista. Dessa listor styr block-fältet i varje verifieringssvar.

{}

Block-fältet

Varje verifieringssvar innehåller ett block-fält. Använd detta fält för att avgöra om e-post/domän ska blockeras enligt dina listor:

trueE-post eller dess domän finns på svartlistan → block: true. När du lägger till en domän blockeras alla e-postadresser på den.

trueVitlistan är aktiverad men e-post/domän finns inte på den → block: true.

falseVitlistan är aktiverad och e-post eller dess domän finns på den → block: false.

—Ingen lista gäller → block följer det vanliga verifieringsresultatet.

Översikt

✘

Svartlista

Blockera alltid vissa e-postadresser eller hela domäner. T.ex. att lägga till example.com på svartlistan gör att alla @example.com returnerar block: true oavsett verifieringsresultat.

✔

Vitlista

Tillåt endast vissa e-postadresser eller domäner. När vitlistan är aktiverad får endast listade poster block: false; allt annat block: true. T.ex. gmail.com tillåter alla @gmail.com medan [email protected] blockeras. När den är av har vitlistan ingen effekt.

Du kan lägga till en fullständig e-post ([email protected]) eller en domän (example.com). En domän gäller alla e-postadresser på den domänen. Skiftläge spelar ingen roll.

Så fungerar det

Utvärderingsordning

Svartlistan först — Om e-postadressen eller dess domän finns på svartlistan blir resultatet block: true. Ingen ytterligare listlogik tillämpas.

Vitlista (om aktiverad) — Om e-post/domän finns på vitlistan → block: false. Annars → block: true.

Vitlista inaktiverad — Endast svartlistan och normal verifiering gäller.

Svartlistan vinner alltid: en adress på svartlistan förblir blockerad även om den finns på vitlistan.

Vad som matchas

E-postverifiering — API:et kontrollerar både hela e-postadressen och domänen mot båda listorna. En träff tillämpar listregeln.

Domänverifiering — endast domänen kontrolleras mot svartlistan och (om aktiverad) vitlistan.

Snabbreferens

Vitlista aktiverad	På svartlistan	På vitlistan	block-värde
Nej	Ja	—	`true`
Nej	Nej	—	Normal
Ja	Ja	Valfri	`true`
Ja	Nej	Ja	`false`
Ja	Nej	Nej	`true`

List-API-slutpunkter

Alla list-slutpunkter kräver header: X-API-Key: your-api-key

Svartlista

GET/v1/blacklist

Lista alla svartlistade poster

POST/v1/blacklist

Lägg till e-post eller domän · { "value": "..." }

DELETE/v1/blacklist

Ta bort post · value=...

Vitlista

GET/v1/whitelist

Lista alla vitlistade poster

POST/v1/whitelist

Lägg till e-post eller domän · { "value": "..." }

DELETE/v1/whitelist

Ta bort post · value=...

GET/v1/whitelist/enabled

Hämta vitlistans status · { "enabled": boolean }

PUT/v1/whitelist/enabled

Aktivera/inaktivera vitlista · { "enabled": true | false }

Exempel på kod (cURL)

✘

Svartlista

GET/v1/blacklist

Lista alla svartlistade poster

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

POST/v1/blacklist

Lägg till e-post eller domän

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

Ta bort post

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

✔

Vitlista

GET/v1/whitelist

Lista alla vitlistade poster

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

POST/v1/whitelist

Lägg till e-post eller domän

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

Ta bort post

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

GET/v1/whitelist/enabled

Hämta vitlistans status

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

PUT/v1/whitelist/enabled

Aktivera/inaktivera vitlista

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

Värdeformat

[email protected] — E-post: giltigt format, t.ex. [email protected]
example.com — Domän: giltigt format, t.ex. example.com

Ogiltiga värden avvisas med 400. Poster lagras normaliserade. Dubbletter slås ihop till en post.

Var listorna tillämpas

Listregler tillämpas efter verifiering. Svar från enstaka och batch e-postverifiering och domänverifiering innehåller redan användarens svart- och vitlista i block-fältet.

MCP Server (AI-agentintegrering)

Integrera e-postverifiering direkt i AI-agenter som Cursor och Claude Desktop med hjälp av MCP (Model Context Protocol). Din AI-assistent kan verifiera e-postmeddelanden, kontrollera domäner och validera syntax utan att lämna redigeringsverktyget.

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.

Inställning

Lägg till följande konfiguration i konfigurationsfilen .cursor/mcp.json eller Claude Desktop:

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

Tillgängliga verktyg

Verktyg	Beskrivning	Ingång	Krediter
verify_email	Fullständig e-postverifiering inklusive syntax-, MX-, SMTP-, engångs-, sekretess- och leveransbarhetskontroller	{ email: string }	1
verify_domain	Fullständig domänverifiering inklusive MX-poster, engångs-, sekretess- och catch-all-detektering	{ domain: string }	1
check_deliverability	Snabb kontroll av leveransbarhet med MX- och SMTP-verifiering utan externa API-anrop	{ email: string }	1
verify_batch	Batchverifiering för upp till 100 e-postmeddelanden eller domäner i en enda begäran	{ inputs: string[] }	1 per item
validate_email_syntax	Snabb lokal syntaxvalidering mot RFC 5322 utan nätverksanrop	{ email: string }	0 (free)