> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/sv/docs/email-blacklist

# E-postblocklista

Utforska API-dokumentationen för E-postblocklista, anropsparametrar, svarsfält, kodexempel och felhantering för DomScan-integrationer.

API för e-postvalidering som upptäcker engångs- eller tillfälliga e-postadresser, rollbaserade adresser och kostnadsfria leverantörer samt kontrollerar domänens anseende. Databasen innehåller över 80 000 engångsdomäner med konfidensnivåerna hög, medel och låg. Användbart för att förebygga registreringsbedrägerier och filtrera potentiella kunder efter kvalitet.

GET /v1/email/check

#### Frågeparametrar

| Parameter | Typ | Description |
| --- | --- | --- |
| email obligatorisk | string | Email address to check (e.g., "user@tempmail.com") |
| checks valfri | string | Kommaseparerade kontroller att köra: `disposable`, `role`, `free`, `mx`, `dnsbl`. Standard: alla |

#### Tillgängliga kontroller

| Kontrollera | Description | Riskpoäng |
| --- | --- | --- |
| `disposable` | Kontrollerar mot en databas med över 80 000 engångsdomäner | +80 |
| `role` | Detects role-based addresses (admin@, support@, etc.) | +20 |
| `free` | Identifierar kostnadsfria e-postleverantörer (gmail, yahoo med flera) | +10 |
| `mx` | Validerar att MX-poster finns för domänen | +50 (om inga finns) |
| `dnsbl` | Kontrollerar domänen mot DNS-blocklistor (Spamhaus med flera) | +15-60 |

#### Risknivåer

- **Låg (0–39)::** Säker att acceptera

- **Medel (40–69)::** Granskning rekommenderas

- **Hög (70–100)::** Troligen bedräglig eller tillfällig

#### Exempelbegäran

```bash
# Full check (all validations)
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/check?email=user@tempmail.com"

# Quick disposable check only
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/check?email=user@gmail.com&checks=disposable"
```

```python
import requests

domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})

response = domscan.get(
    "https://domscan.net/v1/email/check",
    params={"email": "user@tempmail.com"}
)
data = response.json()

if data['risk_level'] == 'high':
    print(f"Reject: {data['flags']}")
elif data['checks']['disposable']['is_disposable']:
    print("Disposable email detected")
```

#### Exempelsvar

```json
{
  "email": "user@tempmail.com",
  "domain": "tempmail.com",
  "local_part": "user",
  "valid_syntax": true,
  "checks": {
    "disposable": {
      "is_disposable": true,
      "confidence": "high"
    },
    "role": {
      "is_role": false,
      "role_type": null
    },
    "free": {
      "is_free": false,
      "provider": null
    },
    "mx": {
      "has_mx": true,
      "records": ["mx.tempmail.com"]
    },
    "dnsbl": {
      "listed": false,
      "threat_level": "none"
    }
  },
  "risk_score": 80,
  "risk_level": "high",
  "flags": ["DISPOSABLE_DOMAIN"],
  "checked_at": "2025-01-15T12:00:00Z"
}
```

#### 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.disposable.matched_pattern` | string |
| `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 \| null |
| `checks.mx.records[]` | string[] |
| `checks.mx.null_mx` | boolean |
| `checks.dnsbl` | object |
| `checks.dnsbl.domain` | string |
| `checks.dnsbl.ip` | string |
| `checks.dnsbl.listed` | boolean |
| `checks.dnsbl.lists[]` | object[] |
| `checks.dnsbl.lists[]` | object |
| `checks.dnsbl.lists[].name` | string |
| `checks.dnsbl.lists[].listed` | boolean |
| `checks.dnsbl.lists[].status` | string |
| `checks.dnsbl.lists[].code` | string |
| `checks.dnsbl.lists[].meaning` | string |
| `checks.dnsbl.lists[].unknown_reason` | string |
| `checks.dnsbl.lists_unknown` | integer |
| `checks.dnsbl.threat_level` | string |
| `checks.dnsbl.check_type` | string |
| `checks.dnsbl.checked_at` | string |
| `risk_score` | integer |
| `risk_level` | string |
| `flags[]` | string[] |
| `checked_at` | string |

POST /v1/email/check/bulk

#### Begärandekropp

| Parameter | Typ | Description |
| --- | --- | --- |
| emails obligatorisk | string[] | Array med e-postadresser att kontrollera (högst 100 per begäran) |
| checks valfri | string[] | Kontroller att köra: ["disposable", "role", "free", "mx", "dnsbl"] |

#### Användningsområden

- Rensa e-postlistor före marknadsföringskampanjer

- Validera användarregistreringar i realtid

- Bedöm potentiella kunder utifrån e-postkvalitet

- Identifiera mönster av registreringsbedrägerier

#### Exempelbegäran

```bash
curl -H "X-API-Key: your-api-key" -X POST "https://domscan.net/v1/email/check/bulk" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": [
      "user@gmail.com",
      "test@tempmail.org",
      "admin@company.com"
    ],
    "checks": ["disposable", "role"]
  }'
```

#### Exempelsvar

```json
{
  "results": [
    {
      "email": "user@gmail.com",
      "risk_level": "low",
      "risk_score": 10,
      "flags": ["FREE_PROVIDER"]
    },
    {
      "email": "test@tempmail.org",
      "risk_level": "high",
      "risk_score": 80,
      "flags": ["DISPOSABLE_DOMAIN"]
    },
    {
      "email": "admin@company.com",
      "risk_level": "medium",
      "risk_score": 20,
      "flags": ["ROLE_ADDRESS"]
    }
  ],
  "summary": {
    "total": 3,
    "disposable": 1,
    "role_based": 1,
    "free_provider": 1,
    "high_risk": 1,
    "medium_risk": 1,
    "low_risk": 1
  },
  "checked_at": "2025-01-15T12:00:00Z"
}
```

#### Svarsfält

| Fält | Typ |
| --- | --- |
| `results[]` | object[] |
| `results[]` | object |
| `summary` | object |
| `summary.total` | integer |
| `summary.disposable` | integer |
| `summary.role_based` | integer |
| `summary.free_provider` | integer |
| `summary.no_mx` | integer |
| `summary.dnsbl_listed` | integer |
| `summary.high_risk` | integer |
| `summary.medium_risk` | integer |
| `summary.low_risk` | integer |
| `checked_at` | string |

GET /v1/email/blacklist

#### Frågeparametrar

| Parameter | Typ | Description |
| --- | --- | --- |
| limit valfri | number | Antal domäner som ska returneras (standard: 1000, max: 10000) |
| offset valfri | number | Pagineringens offset (standard: 0) |
| cursor valfri | string | `next_cursor` från föregående sida. Se [paginering](https://domscan.net/docs/response-format#pagination). |
| format valfri | string | `json` (standard) eller `txt` för en oformaterad textlista |

#### Description

Ladda ner vår blocklista över engångsdomäner. Kostnadsfri för alla användare. Använd `/v1/email/blacklist/download` för hela listan som en nedladdningsbar fil.

#### Exempelbegäran

```bash
# Get first 1000 domains as JSON
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/blacklist"

# Get as plain text for firewall rules
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/blacklist?format=txt&limit=5000"

# Download complete blacklist
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/blacklist/download" -o disposable.json
```

#### Exempelsvar

```json
{
  "domains": [
    "tempmail.com",
    "guerrillamail.com",
    "10minutemail.com",
    "mailinator.com",
    "..."
  ],
  "total": 85432,
  "offset": 0,
  "limit": 1000,
  "metadata": {
    "last_updated": "2025-01-15T00:00:00Z",
    "total_domains": 85432,
    "high_confidence_count": 12500,
    "wildcard_count": 234,
    "sources": [
      "disposable-email-domains",
      "ivolo/disposable-email-domains"
    ]
  }
}
```

#### Svarsfält

| Fält | Typ |
| --- | --- |
| `has_more` | boolean |
| `next_cursor` | string \| null |
| `domains[]` | string[] |
| `total` | integer |
| `offset` | integer |
| `limit` | integer |
| `metadata` | object |
| `metadata.last_updated` | string |
| `metadata.total_domains` | integer |
| `metadata.high_confidence_count` | integer |
| `metadata.wildcard_count` | integer |
| `metadata.sources[]` | string[] |
| `metadata.source_count` | integer |
| `metadata.successful_source_count` | integer |
| `metadata.failed_source_count` | integer |
| `metadata.refresh_cadence_hours` | integer |
| `metadata.refresh_status` | string |
| `metadata.next_refresh_due` | string |
| `metadata.dataset_status` | string |
| `metadata.quality_policy_version` | integer \| null |
| `metadata.quarantined_domain_count` | integer |
| `metadata.rejected_domain_count` | integer |

GET /v1/email/blacklist/download Krediter: 0

#### Frågeparametrar

| Parameter | Typ | obligatorisk |
| --- | --- | --- |
| format | string Tillåtna värden `json`, `txt` Standard `json` | valfri |

#### Svarsfält

| Fält | Typ |
| --- | --- |
| `domains[]` | string[] |
| `wildcards[]` | string[] |
| `metadata` | object |

#### Exempelbegäran

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/blacklist/download?format=json"
```

```javascript
const response = await fetch("https://domscan.net/v1/email/blacklist/download?format=json", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/email/blacklist/download?format=json",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/email/blacklist/download?format=json", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
```

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/email/blacklist/download?format=json")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))
```

#### Exempelsvar

```json
{
  "domains": [
    "example.com",
    "example.org"
  ],
  "wildcards": [
    "example"
  ],
  "metadata": {}
}
```

#### HTTP-statuskoder

- `200` OK
- `401` Obehörig
- `429` För många begäranden
