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. test@example.com 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": "test@example.com",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Exempel på kod

curl "https://api.verify-email.app/v1/verify?input=test@example.com" \
  -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": [
      "test1@example.com",
      "test2@example.com"
    ]
  }'

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. test@example.com). 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": "test@example.com",
  "remaining_credits": 99
}

Exempel på kod

curl "https://api.verify-email.app/v1/verify/deliverable?input=test@example.com" \
  -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 user@yahoo.com blockeras. När den är av har vitlistan ingen effekt.

Du kan lägga till en fullständig e-post (user@example.com) 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 }

Värdeformat

user@example.com — E-post: giltigt format, t.ex. user@example.com
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.

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)