Perform a single email risk assessment.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

or

Body Params application/jsonRequired

Example

{
    "email": "user@example.com",
    "metadata": {}
}

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.antitempmail.com/api/v1/email/check' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "user@example.com",
    "metadata": {}
}'

Responses

🟢200OK

application/json

Successful risk analysis.

Headers

Body

Example

{
    "success": true,
    "apiVersion": "2025-03-17",
    "data": {
        "email": "user@example.com",
        "domain": "example.com",
        "risk_score": 23,
        "risk_level": "safe",
        "signals": [
            {
                "type": "temp_domain_match",
                "severity": "high",
                "weight": 45,
                "description": "Domain matches known disposable provider",
                "evidence": {
                    "provider": "mailinator.com"
                }
            }
        ],
        "explanation": "Domain looks legitimate with no high-risk indicators.",
        "recommendation": "Allow the request and continue monitoring.",
        "check_time_ms": 173,
        "checked_at": "2025-03-17T02:15:21.122Z"
    },
    "meta": {
        "requestId": "req_123",
        "timestamp": "2025-03-17T02:15:21.122Z",
        "docsUrl": "https://docs.antitempmail.com",
        "rateLimit": {
            "limit": 60,
            "remaining": 57,
            "resetAt": "2025-03-17T02:16:00Z"
        },
        "credits": {
            "remaining": 998,
            "used": 1,
            "unit": "credits"
        },
        "processingMs": 173,
        "modelVersion": "risk-scorer-v1",
        "thresholds": {
            "safe": 30,
            "suspicious": 60,
            "danger": 60
        },
        "checkType": "single"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠402Payment Required

🟠429Too Many Requests