---
title: Disposable Email Checker API - Detect Temporary & Throwaway Email Addresses
version: 1.0.0
description: Check a single email address for disposable/temporary domains, free webmail providers, spam-listed domains, and role-based accounts, with syntax validation and DNS record lookup (MX/A). Returns a minimal shape for syntactically invalid addresses and omits the domain/account/dns detail blocks when the domain cannot be resolved. Optionally pass an ip to also get its geolocation and security signals (same format as the Email Checker's address object).
openapi: 3.1.1
servers:
  - https://api.apifreaks.com/v2.0
paths: 1
operations: 1
schemas: 9
---

## Table of Contents

- [Disposable Email Checker API - Detect Temporary & Throwaway Email Addresses v1.0.0](#disposable-email-checker-api-detect-temporary-throwaway-email-addresses-v100)
  - [Authentication](#authentication)
  - [Email Validation APIs](#email-validation-apis)
    - [checkDisposableEmail](#checkdisposableemail)
      - [Parameters](#parameters)
      - [Responses](#responses)
  - [Schemas](#schemas)
    - [DisposableEmailCheckResponse](#disposableemailcheckresponse)
    - [DisposableDomainObject](#disposabledomainobject)
    - [DisposableAccountObject](#disposableaccountobject)
    - [DisposableDnsObject](#disposablednsobject)
    - [ErrorResponse](#errorresponse)
    - [DisposableEmailCheckRequest](#disposableemailcheckrequest)
    - [AddressObject](#addressobject)
    - [EmailLocation](#emaillocation)
    - [EmailSecurity](#emailsecurity)



# Disposable Email Checker API - Detect Temporary & Throwaway Email Addresses v1.0.0

Check a single email address for disposable/temporary domains, free webmail providers, spam-listed domains, and role-based accounts, with syntax validation and DNS record lookup (MX/A). Returns a minimal shape for syntactically invalid addresses and omits the domain/account/dns detail blocks when the domain cannot be resolved. Optionally pass an ip to also get its geolocation and security signals (same format as the Email Checker's address object).

Base URLs:

* [https://api.apifreaks.com/v2.0](https://api.apifreaks.com/v2.0)

## Authentication

* API Key (ApiKeyAuthHeader)
    - Parameter Name: **X-apiKey**, in: header. Pass your API key via the X-apiKey request header.

* API Key (ApiKeyAuthQuery)
    - Parameter Name: **apiKey**, in: query. Pass your API key via the apiKey query parameter.

## Email Validation APIs

### checkDisposableEmail

`POST /email/disposable-check`

*Check a single email for disposable/temporary domain*

Validates email syntax and checks the domain for disposable, free, spam, and role-account signals, plus MX/A DNS records. Send the email (and optionally an ip) as a JSON request body. When an ip is included, the response also carries geolocation and security data for it.

> Body parameter

```json
{
  "email": "test@sogetthis.com"
}
```

#### Parameters

|Name|In|Type|Required|Description|
|---|---|---|---|---|
|format|query|string|false|Format of the response.|
|body|body|[DisposableEmailCheckRequest](#disposableemailcheckrequest)|true|none|

##### Enumerated Values

|Parameter|Value|
|---|---|
|format|json|
|format|xml|

> Example responses

> Successful response with disposable email check result.

```json
{
  "email": "test@sogetthis.com",
  "validSyntax": true,
  "domain": {
    "disposable": true,
    "free": false,
    "name": "sogetthis.com",
    "spam": false,
    "validDomain": true
  },
  "account": {
    "role": false
  },
  "dns": {
    "mxRecord": [
      "mail.mailinator.com."
    ]
  }
}
```

```json
{
  "email": "someone@gmail.com",
  "validSyntax": true,
  "domain": {
    "disposable": false,
    "free": true,
    "name": "gmail.com",
    "spam": false,
    "validDomain": true
  },
  "account": {
    "role": false
  },
  "dns": {
    "mxRecord": [
      "gmail-smtp-in.l.google.com.",
      "alt1.gmail-smtp-in.l.google.com.",
      "alt2.gmail-smtp-in.l.google.com.",
      "alt3.gmail-smtp-in.l.google.com.",
      "alt4.gmail-smtp-in.l.google.com."
    ]
  }
}
```

```json
{
  "email": "support@microsoft.com",
  "validSyntax": true,
  "domain": {
    "disposable": false,
    "free": false,
    "name": "microsoft.com",
    "spam": false,
    "validDomain": true
  },
  "account": {
    "role": true
  },
  "dns": {
    "mxRecord": [
      "microsoft-com.mail.protection.outlook.com."
    ]
  }
}
```

```json
{
  "email": "test@rotodirect.com",
  "validSyntax": true,
  "domain": {
    "disposable": false,
    "free": false,
    "name": "rotodirect.com",
    "spam": false,
    "validDomain": true
  },
  "account": {
    "role": false
  },
  "dns": {
    "aRecord": [
      "166.78.44.241"
    ]
  }
}
```

```json
{
  "email": "test@mailblacklist.com",
  "validSyntax": true,
  "domain": {
    "disposable": false,
    "free": false,
    "name": "mailblacklist.com",
    "spam": false,
    "validDomain": true
  },
  "account": {
    "role": false
  },
  "dns": {
    "mxRecord": [
      "."
    ]
  }
}
```

```json
{
  "email": "abc",
  "validSyntax": false,
  "domain": {
    "name": "abc",
    "validDomain": false
  }
}
```

```json
{
  "email": "test@xxxxxyyyyy123spam.com",
  "validSyntax": true,
  "domain": {
    "disposable": false,
    "free": false,
    "name": "xxxxxyyyyy123spam.com",
    "spam": false,
    "validDomain": false
  },
  "account": {
    "role": false
  }
}
```

```json
{
  "email": "someone@gmail.com",
  "validSyntax": true,
  "domain": {
    "disposable": false,
    "free": true,
    "name": "gmail.com",
    "spam": false,
    "validDomain": true
  },
  "account": {
    "role": false
  },
  "dns": {
    "mxRecord": [
      "gmail-smtp-in.l.google.com.",
      "alt1.gmail-smtp-in.l.google.com.",
      "alt2.gmail-smtp-in.l.google.com.",
      "alt3.gmail-smtp-in.l.google.com.",
      "alt4.gmail-smtp-in.l.google.com."
    ]
  },
  "ip": "8.8.8.8",
  "address": {
    "validIpAddress": true,
    "location": {
      "city": "Mountain View",
      "district": "Santa Clara",
      "zipcode": "94043-1351",
      "state_prov": "California",
      "country_name": "United States",
      "continent_name": "North America",
      "continent_code": "NA",
      "country_code2": "US",
      "country_code3": "USA",
      "country_name_official": "United States of America",
      "is_eu": false
    },
    "security": {
      "threat_score": 5,
      "is_tor": false,
      "is_proxy": false,
      "is_anonymous": false,
      "is_known_attacker": false,
      "is_spam": false,
      "is_bot": false,
      "is_cloud_provider": true,
      "cloud_provider": "Google LLC"
    }
  }
}
```

```json
{
  "email": "someone@gmail.com",
  "validSyntax": true,
  "domain": {
    "disposable": false,
    "free": true,
    "name": "gmail.com",
    "spam": false,
    "validDomain": true
  },
  "account": {
    "role": false
  },
  "dns": {
    "mxRecord": [
      "gmail-smtp-in.l.google.com.",
      "alt1.gmail-smtp-in.l.google.com.",
      "alt2.gmail-smtp-in.l.google.com.",
      "alt3.gmail-smtp-in.l.google.com.",
      "alt4.gmail-smtp-in.l.google.com."
    ]
  },
  "ip": "10.0.0.1",
  "address": {
    "validIpAddress": false
  }
}
```

> Bad Request – Missing API key

```json
{
  "error": "Invalid Param Exception",
  "message": "Please provide apiKey",
  "path": "/v2.0/email/disposable-check",
  "status": 400,
  "timestamp": "2026-10-13T10:40:12.475Z"
}
```

> Unauthorized – Invalid API key

```json
{
  "error": "API Access Exception",
  "message": "Provided API key is invalid. [For Technical Support: support@apifreaks.com]",
  "path": "/v2.0/email/disposable-check",
  "status": 401,
  "timestamp": "2026-10-13T10:40:13.056Z"
}
```

> Not Found – The requested resource could not be found

```json
{
  "error": "Resource Not Found",
  "message": "The requested resource could not be found. Please verify the URL and try again.",
  "path": "/v2.0/email/disposable-checkx",
  "status": 404,
  "timestamp": "2026-10-13T11:00:07.798Z"
}
```

#### Responses

|Status|Meaning|Description|Schema|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|Successful response with disposable email check result.|[DisposableEmailCheckResponse](#disposableemailcheckresponse)|
|400|[Bad Request](https://tools.ietf.org/html/rfc7231#section-6.5.1)|Bad Request – Missing API key|[ErrorResponse](#errorresponse)|
|401|[Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)|Unauthorized – Invalid API key|[ErrorResponse](#errorresponse)|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found – The requested resource could not be found|[ErrorResponse](#errorresponse)|

#### Response Headers

|Status|Header|Type|Format|Description|
|---|---|---|---|---|
|200|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request. 15 credits per checked record.|
|200|X-Concurrent-Threads|integer||Specifies the maximum number of concurrent requests allowed.|
|200|X-Concurrent-Threads-Active|integer||Indicates the number of active concurrent requests being processed.|
|400|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request. 15 credits per checked record.|
|404|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request. 15 credits per checked record.|

To perform this operation, you must be authenticated by means of one of the following methods:
ApiKeyAuthHeader, ApiKeyAuthQuery

## Schemas

### DisposableEmailCheckResponse

Disposable email check response.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|email|string|true|none|The email address submitted for the check.|
|validSyntax|boolean|true|none|Validates email address format compliance with RFC 5322 standards. When false, domain only contains name/validDomain and account/dns are omitted entirely.|
|domain|[DisposableDomainObject](#disposabledomainobject)|true|none|Domain-level disposable/spam/free classification for the email address.|
|account|[DisposableAccountObject](#disposableaccountobject)|false|none|Account-level detection details. Omitted entirely when validSyntax is false.|
|dns|[DisposableDnsObject](#disposablednsobject)|false|none|DNS records for the email domain. Omitted entirely when validSyntax is false or the domain does not exist (NXDOMAIN).|
|ip|any|false|none|The IP address that was looked up.|

anyOf

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|» *anonymous*|string(ipv4)|false|none|none|

or

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|» *anonymous*|string(ipv6)|false|none|none|

continued

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|address|[AddressObject](#addressobject)|false|none|Geolocation and security enrichment data for the IP address.|

### DisposableDomainObject

Domain-level disposable/spam/free classification for the email address.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|name|string|true|none|Extracted domain component from the email address.|
|validDomain|boolean|true|none|Domain validation status confirming DNS resolution capability.|
|disposable|boolean|false|none|Classification flag identifying domains from temporary/throwaway email service providers. Omitted when validSyntax is false or the domain could not be resolved.|
|free|boolean|false|none|Classification indicating free or consumer-grade email service providers. Omitted when validSyntax is false or the domain could not be resolved.|
|spam|boolean|false|none|Reputation indicator flagging domains on spam databases. Omitted when validSyntax is false or the domain could not be resolved.|

### DisposableAccountObject

Account-level detection details. Omitted entirely when validSyntax is false.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|role|boolean|true|none|Detection flag identifying role-based email addresses (e.g., admin@, support@).|

### DisposableDnsObject

DNS records for the email domain. Omitted entirely when validSyntax is false or the domain does not exist (NXDOMAIN).

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|mxRecord|[string]|false|none|Every MX hostname at the domain's lowest preference (not just one). ["."]  means the domain publishes a null MX and accepts no mail at all. Absent entirely when the domain has no MX record of any kind — check aRecord in that case.|
|aRecord|[string]|false|none|Collection of A (Address) records for the domain. Present when the domain has no MX record but does resolve to a web server or other host.|

### ErrorResponse

Standard error envelope returned by the API on failed requests.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|error|string|false|none|Short error category or exception type.|
|message|string|true|none|Human-readable error message describing the failure.|
|path|string|false|none|API endpoint path that produced the error.|
|status|integer|false|none|HTTP status code returned with the error.|
|timestamp|string(date-time)|false|none|Timestamp when the error occurred (ISO 8601).|

### DisposableEmailCheckRequest

Request body for the disposable email check.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|email|string(email)|true|none|The email address to check.|
|ip|any|false|none|Optional IP address to look up for location and security data, such as the IP the signup came from.|

anyOf

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|» *anonymous*|string(ipv4)|false|none|none|

or

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|» *anonymous*|string(ipv6)|false|none|none|

### AddressObject

Geolocation and security enrichment data for the IP address.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|validIpAddress|boolean|false|none|IP recognized/reachable by the geolocation provider.|
|location|[EmailLocation](#emaillocation)|false|none|Geolocation data derived from the IP address.|
|security|[EmailSecurity](#emailsecurity)|false|none|Threat and anonymity profile for the IP address.|

### EmailLocation

Geolocation data derived from the IP address.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|city|string|false|none|Municipal or city name.|
|district|string|false|none|District or neighborhood.|
|zipcode|string|false|none|Postal or ZIP code.|
|state_prov|string|false|none|State or province.|
|country_name|string|false|none|Common country name.|
|country_name_official|string|false|none|Official country name.|
|country_code2|string|false|none|Two-character ISO country code.|
|country_code3|string|false|none|Three-character ISO country code.|
|continent_name|string|false|none|Continental region name.|
|continent_code|string|false|none|Continental region identifier.|
|accuracy_radius|string|false|none|Geolocation precision radius. Not included for every IP.|
|confidence|string|false|none|Confidence score for geolocation accuracy. Not included for every IP.|
|is_eu|boolean|false|none|European Union membership status.|

### EmailSecurity

Threat and anonymity profile for the IP address.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|threat_score|integer|true|none|Quantitative risk assessment score. Higher values indicate elevated security risk.|
|is_tor|boolean|true|none|Detection flag for IP addresses routed through the Tor anonymity network.|
|is_proxy|boolean|true|none|Detection flag identifying IP addresses operating as proxy servers.|
|proxy_type|string|false|none|Classification of detected proxy infrastructure type (e.g. VPN, HTTP, SOCKS). Included only when is_proxy is true.|
|proxy_provider|string|false|none|Identified service provider operating the proxy infrastructure. Included only when is_proxy is true.|
|is_anonymous|boolean|true|none|Anonymization detection flag for IP addresses using identity obfuscation techniques.|
|is_known_attacker|boolean|true|none|Threat intelligence flag for IP addresses documented as confirmed malicious sources.|
|is_spam|boolean|true|none|Reputation flag for IP addresses associated with spam transmission.|
|is_bot|boolean|true|none|Automated traffic detection flag for IP addresses from bot networks.|
|is_cloud_provider|boolean|true|none|Infrastructure classification flag for IP addresses from cloud computing providers.|
|cloud_provider|string|true|none|Identified cloud infrastructure or hosting service provider name.|