---
title: Temporary and Disposable Emails API
slug: temporary-and-disposable-emails-api
url: https://apyhub.com/boomlify/service/temporary-and-disposable-emails-api
provider: Boomlify
categories: [Verification Kit]
tags: [temporary-email, disposable-email, email-inbox, throwaway-email, email-testing, burner-email]
auth: api_key
version: v1
service_type: sync
endpoints: 3
atoms: 25
mcp: true
alias: boomlify-temp-mail
---

# Temporary and Disposable Emails API

Temp mail API for developers: create disposable inboxes that last 10 minutes to permanently, read messages as JSON, and use custom domains. Free tier, no card.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/boomlify/temporary-and-disposable-emails-api` | What it does Creates a temporary email address. You can control the email lifetime with the time qu… | 25 |
| GET | `https://api.eu.apyhub.com/boomlify/temporary-and-disposable-emails-api/messages/:id` | What it does Retrieves email messages for the email address identified by the path id. The response… | 25 |
| DELETE | `https://api.eu.apyhub.com/boomlify/temporary-and-disposable-emails-api/:id` | What it does Deletes a temporary email identified by its UUID path parameter. The response returns… | 25 |

## Endpoint reference

### Create Temporary Email

`POST https://api.eu.apyhub.com/boomlify/temporary-and-disposable-emails-api` · 25 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `time` | query | string | no | One of: 10min, 1hour, 1day, permanent. Default: `10min`. Example: `10min`. |
| `domain` | query | string | no | Example: `example.com`. |

#### Quickstart

Create a temporary email address with the default 10-minute lifetime.

```bash
curl -X POST "https://api.eu.apyhub.com/boomlify/temporary-and-disposable-emails-api?time=10min" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with top-level `success` and `message` fields, a `meta` object with a `timestamp`, and a `data` object containing the created email details.

- `success` is a boolean indicating whether the request succeeded.
- `message` is a status string.
- `meta.timestamp` is an ISO 8601 date-time string.
- `data` is an object that includes `email`, `meta`, and `success`.

```json
{
  "success": true,
  "message": "Request processed successfully",
  "meta": {
    "timestamp": "2023-10-27T10:00:00Z"
  },
  "data": {
    "success": true,
    "meta": {
      "tier": "10min",
      "user_id": "user_123",
      "request_time": "2023-10-27T10:00:00Z"
    },
    "email": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "domain": "example.com",
      "address": "demo@example.com",
      "time_tier": "10min",
      "created_at": "2023-10-27T10:00:00Z",
      "expires_at": "2023-10-27T10:10:00Z",
      "time_remaining": {
        "minutes": 10,
        "seconds": 0,
        "total_ms": 600000,
        "human_readable": "10 minutes"
      },
      "is_custom_domain": false
    }
  }
}
```

### Retrieve Email Messages

`GET https://api.eu.apyhub.com/boomlify/temporary-and-disposable-emails-api/messages/:id` · 25 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string (uuid) | yes | Example: `550e8400-e29b-41d4-a716-446655440000`. |
| `limit` | query | integer | no | Default: `25`. Example: `25`. |
| `offset` | query | integer | no | Default: `0`. Example: `0`. |

#### Quickstart

Fetch a single message by its UUID.

```bash
curl -X GET "https://api.eu.apyhub.com/boomlify/temporary-and-disposable-emails-api/messages/:id" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with `data`, `meta`, `message`, and `success` fields. The `data` field is an object containing the message response payload, `meta.timestamp` is a date-time string, `message` is a status message, and `success` is a boolean.

```json
{
  "data": {},
  "meta": {
    "timestamp": "2023-10-27T10:00:00Z"
  },
  "message": "Request processed successfully",
  "success": true
}
```

### Delete Temporary Email

`DELETE https://api.eu.apyhub.com/boomlify/temporary-and-disposable-emails-api/:id` · 25 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string (uuid) | yes |  |

#### Quickstart

Delete a temporary email by its UUID `id`.

```bash
curl -X DELETE "https://api.eu.apyhub.com/boomlify/temporary-and-disposable-emails-api/:id" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with `data`, `meta`, `message`, and `success` fields. The `data` field is an object containing response details such as `meta`, `message`, and `success`.

```json
{
  "data": {
    "meta": {
      "user_id": "user_123",
      "email_id": "550e8400-e29b-41d4-a716-446655440000",
      "deleted_at": "2023-10-27T10:00:00Z"
    },
    "message": "Request processed successfully",
    "success": true
  },
  "meta": {
    "timestamp": "2023-10-27T10:00:00Z"
  },
  "message": "Request processed successfully",
  "success": true
}
```

## About

## What it does
The Temp Mail API creates temporary, disposable email inboxes on demand. Choose how long each inbox lives (10 minutes, 1 hour, 1 day, or permanent), optionally use your own domain, and read incoming messages as JSON, including sender, subject, and HTML or plain-text body. Delete an inbox as soon as you're done with it.

Use it to test sign-up and verification emails, run automated QA flows, and keep throwaway registrations out of real mailboxes. Each call costs 25 atoms, and you can start on ApyHub's free tier: 5 API calls per day and 3,000 atoms per month, with no card required.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/boomlify/service/temporary-and-disposable-emails-api
