---
updatedAt: 2026-07-02T14:53:34.000Z
agentTools:
  projectIndex: https://docs.trustfull.com/llms.txt
---

# Email Disposable

This page will help you get started with Disposable Phones API

The Disposable Email endpoint enables you to determine whether an email address is associated with a temporary or disposable provider. This check is a valuable tool in fraud prevention workflows, helping you assess the trustworthiness of user-provided emails.

## Request

Following an example of an **Email Disposable**

```shell
curl --request POST \
     --url https://api.trustfull.com/data/1.0/email-disposable \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'x-api-key: [your_app_key]' \
     --data '
{
     "transaction_id": "your_transaction_id",
     "email": "tony-stark@gmail.com"
}'
```

Here's a detailed explanation of all fields needed for the API call:

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        name
      </th>

      <th>
        type
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        transaction_id
      </td>

      <td>
        **string**

        A unique identifier for the transaction. Duplicate values are not allowed.

        e.g.: 4115d9d9-28f4-4100-8701-cafe2adbc4c2
      </td>
    </tr>

    <tr>
      <td>
        email
      </td>

      <td>
        **string**

        The email to analyze.

        e.g.:  [tony-stark@gmail.com](mailto:tony-stark@gmail.com)
      </td>
    </tr>
  </tbody>
</Table>

## Response

Following is an example of the response:

```shell

{
   "is_valid_format": true,
   "is_disposable": true,
   "disposable_provider": "tempmail.com"
}
```

Here's a detailed explanation of all fields returned:

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        name
      </th>

      <th>
        type
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        is_valid_format
      </td>

      <td>
        **boolean**

        Indicates if the email you provided has a valid format

        e.g.: true
      </td>
    </tr>

    <tr>
      <td>
        is_disposable
      </td>

      <td>
        **?boolean**

        Indicates if the email belongs to a temporary service provider

        e.g.: true
      </td>
    </tr>

    <tr>
      <td>
        disposable_provider
      </td>

      <td>
        **?string**

        When detected, it indicates the temporary email service provider

        e.g.: tempmail.com
      </td>
    </tr>
  </tbody>
</Table>

## FAQ

The following are some common questions for this specific API:

> 📘 Why do you need to pass a transaction\_id?
>
> This value is useful to refer to a specific transaction in the system. Using only the email can lead to collision in case of duplicated call for the same email. Transaction id must be unique across all trustfull API endpoints.

> 📘 What happens if I pass an invalid email?
>
> We strongly encourage you to validate the email before making a request
> If the email provided has an invalid format, the response will only include the is\_valid\_format field (false)—charged at the same rate as a standard API call.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "direct",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.trustfull.com/data/1.0/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY",
        "x-default": "[YOUR API KEY]"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/email-disposable": {
      "post": {
        "summary": "Email Disposable",
        "description": "This page will help you get started with Disposable Phones API",
        "operationId": "email-disposable",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "transaction_id",
                  "ip"
                ],
                "properties": {
                  "transaction_id": {
                    "type": "string",
                    "description": "The unique identifier of this transaction. Duplicated value are not allowed."
                  },
                  "ip": {
                    "type": "string",
                    "description": "The IP address to be inspected."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": {
                      "is_valid_format": true,
                      "is_disposable": true,
                      "disposable_provider": "tempmail.com"
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "is_valid_format": {
                      "type": "boolean",
                      "example": true,
                      "default": true
                    },
                    "is_vpn": {
                      "type": "boolean",
                      "example": true,
                      "default": true
                    },
                    "is_relay": {
                      "type": "boolean",
                      "example": "freesms.net"
                    },
                    "is_proxy": {
                      "type": "boolean"
                    },
                    "is_tor": {
                      "type": "boolean"
                    },
                    "proxy_type": {
                      "type": "string",
                      "enum": [
                        "residential",
                        "datacenter"
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```