Check Email API

📝 Description

In addition to the basic feature of verifying the existence of an email address, this API also checks whether that Gmail account requires phone number verification when logging in.

🔗 HTTP Request

GET https://app.sonjj.com/v1/check_email/?email=string HTTP/1.1
Host: app.sonjj.com
Accept: application/json
X-Api-Key: your_api_key_here

📋 Parameters

📄 Example Responses

200 Response

{
  "type": "string",
  "disposable": "string",
  "status": "string",
  "avatar": "string"
}

📤 Responses

📝 Description

Check Gmail account existence, status and retrieve avatar if available. This API specifically checks Gmail accounts for their verification requirements and account status.

🔗 HTTP Request

GET https://app.sonjj.com/v1/check_gmail/?email=example%40gmail.com HTTP/1.1
Host: app.sonjj.com
Accept: application/json
X-Api-Key: your_api_key_here

📋 Parameters

📄 Example Responses

200 Response

{
  "email": "string",
  "status": "Ok",
  "avatar": "string"
}

📤 Responses

📝 Description

Check Microsoft account existence and status for Outlook, Hotmail, Live, and MSN email addresses. This API determines if the account exists and what verification requirements it has.

🔗 HTTP Request

GET https://app.sonjj.com/v1/check_microsoft/?email=example%40outlook.com HTTP/1.1
Host: app.sonjj.com
Accept: application/json
X-Api-Key: your_api_key_here

📋 Parameters

📄 Example Responses

200 Response

{
  "email": "string",
  "status": "Ok",
  "details": {}
}

📤 Responses

📝 Description

Check if a domain is used for disposable/temporary email with a scoring system (0-100).

**🚀 Performance**: This endpoint is optimized for Cloudflare edge caching with intelligent TTL:
- **High confidence disposable** (score ≥80, confidence ≥90): Cached for 1 year
- **Medium confidence disposable** (score ≥60, confidence ≥80): Cached for 30 days
- **Legitimate domains** (score ≤20, confidence ≥90): Cached for 7 days
- **Uncertain cases**: Cached for 1 hour only

**Scoring System:**
- **0 points**: Definitely legitimate (Gmail, Outlook, Yahoo, major providers)
- **1-30 points**: Low risk (corporate domains, unknown but legitimate-looking)
- **31-60 points**: Medium risk (suspicious patterns, questionable TLDs)
- **61-85 points**: High risk (catch-all domains, pattern matches)
- **86-100 points**: Very High risk (known disposable, definitely temporary)

**Return Format:**
- `score`: Integer from 0-100 indicating disposability risk
- Detection method logged internally for debugging
- User can implement their own risk logic based on score only
- Response includes cache optimization headers for Cloudflare

🔗 HTTP Request

GET https://app.sonjj.com/v1/check_disposable_email/?domain=10minutemail.com HTTP/1.1
Host: app.sonjj.com
Accept: application/json
X-Api-Key: your_api_key_here

📋 Parameters

📄 Example Responses

Major email providers get score 0 - definitely legitimate

{
  "domain": "gmail.com",
  "score": 0
}

Known temporary email services get score 100

{
  "domain": "10minutemail.com",
  "score": 100
}

Domains with suspicious patterns get medium-high risk scores

{
  "domain": "tempmail.org",
  "score": 55
}

Unknown but legitimate-looking corporate domains get low scores

{
  "domain": "company.com",
  "score": 10
}

422 Response

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

📤 Responses