---
title: "Detect Disposable"
method: GET
path: "/detect-disposable"
---

# Detect Disposable

`GET /detect-disposable`

## Request

- Base URL: `https://api.minelead.io/v1`
- URL: `https://api.minelead.io/v1/detect-disposable`
- Auth: API key in query parameter `key`

Check if an email address is from a disposable email provider

## Query parameters

- `key` string, required
- `email` string, required

## Response `200`

Disposable email detection result

- DetectDisposable
  - `status` string: Request status
  - `email` string: The email address that was checked
  - `disposability_score` number: Score indicating disposability level (0-5, higher is more disposable)
  - `format_valid` boolean: Whether the email format is valid
  - `spam_score` string: Spam score assessment
  - `domain_type` 'business' | 'personal': Type of domain
  - `disposable_status` 'Disposable' | 'Not Disposable' | 'Unknown': User-friendly disposable status for UI display
  - `a_record_status` 'Present' | 'Missing' | 'Unknown': User-friendly A record status for UI display
  - `ptr_record_status` 'Present' | 'Missing' | 'Unknown': User-friendly PTR record status for UI display
  - `mx_record_status` 'Present' | 'Missing' | 'Unknown': User-friendly MX record status for UI display
  - `timestamp` number: Timestamp of the check

---

[API](https://skmtc.dev/minelead/apis/minelead-api.md) · [All operations](https://skmtc.dev/minelead/apis/minelead-api/llms.txt) · [OpenAPI document](https://skmtc.dev/minelead/apis/minelead-api/revisions/c61c296b019b?raw)