E-postsvartlista API-referens

Det här får du

Kontrollera om en domän eller IP är listad på e-post svartlistor.

SynkrontBulkRESTMCPSDKInteraktivt verktyg

Välj denna produkt när

Vem är det till för?

Använd avgränsade passiva kontroller för att berika triage och utredning, inte för att ersätta auktoriserad testning eller mänsklig granskning.

Välj denna produkt när

Välj detta för att kontrollera stödda svartlistebevis vid en viss tidpunkt. Ett rent resultat är ingen universell ryktesgaranti.

Det här får du

Kontrollera om en domän eller IP är listad på e-post svartlistor.

Endpoints

Granska stödda operationer, indata, utdata, körningslägen och svarsbegränsningar innan du integrerar.

GET /v1/email/check Visa API-referens

POST /v1/email/check/bulk Visa API-referens

GET /v1/email/blacklist Visa API-referens

GET /v1/email/blacklist/download Visa API-referens

Credits och autentisering

0-1 Autentisering krävs. Se operationsreferensen för exakt kostnad och eventuell prissättning per objekt.

Exempel på operation

Använd dokumenterade operationer för att samla in, bedöma, berika, verifiera, jämföra, skydda eller övervaka offentliga bevis.

GET /v1/email/check

Frågeparametrar

Parameter	Typ	obligatorisk
email	string	obligatorisk
checks	string	valfri

Svarsfält

Fält	Typ
`email`	string
`domain`	string
`local_part`	string
`valid_syntax`	boolean
`checks`	object
`checks.disposable`	object
`checks.disposable.is_disposable`	boolean
`checks.disposable.confidence`	string \| null
`checks.role`	object
`checks.role.is_role`	boolean
`checks.role.role_type`	string \| null
`checks.free`	object
`checks.free.is_free`	boolean
`checks.free.provider`	string \| null
`checks.mx`	object
`checks.mx.has_mx`	boolean
`checks.mx.records[]`	string[]
`checks.dnsbl`	object
`checks.dnsbl.listed`	boolean
`checks.dnsbl.threat_level`	string
`risk_score`	integer
`risk_level`	string
`flags[]`	string[]
`checked_at`	string

Exempelbegäran

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl"

Exempelsvar

{
  "email": "[email protected]",
  "domain": "tempmail.org",
  "local_part": "user",
  "valid_syntax": true,
  "checks": {
    "disposable": {
      "is_disposable": true,
      "confidence": "high"
    },
    "role": {
      "is_role": false,
      "role_type": "domain"
    },
    "free": {
      "is_free": false,
      "provider": "example"
    },
    "mx": {
      "has_mx": true,
      "records": [
        "mx1.tempmail.org"
      ]
    },
    "dnsbl": {
      "listed": false,
      "threat_level": "none"
    }
  },
  "risk_score": 80,
  "risk_level": "high",
  "flags": [
    "DISPOSABLE_DOMAIN"
  ],
  "checked_at": "2026-08-27T12:00:00Z"
}

Begränsningar och bevisgränser

Resultaten beskriver observerade offentliga bevis och deras ursprung.

Okänt betyder att den begärda uppgiften inte kunde fastställas utifrån tillgängliga bevis.

Bulkoperationer behandlar flera stödda indata och bevarar dokumenterade resultat per objekt.

Täckningen begränsas av dokumenterade indata, budgetar, källor och svarsbegränsningar.

Bevis kan förändras över tid. Använd tidsstämplar och fält för aktualitet när de finns.

Granskad 2026-08-22

Relaterade produkter

Vanliga frågor

Var hittar jag request- och response-referensen för E-postsvartlista?

Använd API-referensen för E-postsvartlista för att granska parametrar, svarsfält, exempel, statuskoder och stödda körningslägen.

Hur ska jag tolka okända eller ofullständiga resultat från E-postsvartlista?

Okända eller partiella resultat betyder att de begärda bevisen inte kunde fastställas helt. Behåll resultatstatus, konfidens, aktualitet och begränsningar i efterföljande beslut.

Hur prissätts E-postsvartlista?

Priset beror på operation och körningsläge. Se endpointreferensen för aktuell creditkostnad, autentiseringskrav och regler per objekt.