API Documentation

Integrate MMOIT.COM into your applications. Create temporary emails, manage mailboxes, and fetch messages programmatically.

Base URL https://tmeo.net/api

Authentication

All API endpoints require a valid API key passed as a URL parameter {key}. Additionally, most endpoints require email + password authentication via query parameters.

List Domains

GET /api/domains/{key}

Returns a list of all available email domains.

URL Parameters

key string API key required

200 Success

Response

[
  "xacminhnhanh.com",
  "example.com"
]

Create Email

GET /api/email/{email}/{key}

Create a new temporary email address with an optional password. If no password is provided, a random one will be generated.

URL Parameters

email string Full email address (e.g. user@domain.com) required

key string API key required

Query Parameters

password string Custom password for the email optional

200 Success

Response
{
  "email": "user@xacminhnhanh.com",
  "password": "Test1234",
  "error": null
}

406 Validation Error

Response

{
  "error": "Username not allowed"
}

GET /api/login/{key}

Verify email and password credentials. Use this to authenticate before accessing a mailbox.

URL Parameters

key string API key required

Query Parameters

email string Email address required

password string Password required

200 Success

Response
{
  "success": true,
  "email": "user@xacminhnhanh.com"
}

401 Invalid Credentials

Response

{
  "error": "Invalid email or password"
}

422 Missing Parameters

Response

{
  "error": "Email and password are required"
}

Fetch Messages

GET /api/messages/{email}/{key}

Retrieve all messages for a given email address. Requires password authentication.

URL Parameters

email string Email address required

key string API key required

Query Parameters

password string Password for this email required

200 Success

Response
[
  {
    "subject": "Welcome to CapCut",
    "sender_name": "CapCut",
    "sender_email": "admin@mail.capcut.com",
    "date": "2026/02/10 13:37:55",
    "datediff": "5 minutes ago",
    "id": 66,
    "content": "<html>...</html>",
    "attachments": []
  }
]

422 Missing Password

Response

{
  "error": "Password is required"
}

Get Message

GET /api/message/{id}/{key}

Retrieve a single message by ID. You must prove ownership by providing the email and password that the message belongs to.

URL Parameters

id integer Message ID required

key string API key required

Query Parameters

email string Email address (owner) required

password string Password required

200 Success

Response
{
  "id": 6,
  "subject": "Welcome to CapCut",
  "from": "CapCut <admin@mail.capcut.com>",
  "to": "user@xacminhnhanh.com",
  "body": "<html>...</html>",
  "attachments": null,
  "is_seen": 1,
  "created_at": "2026-02-10T13:39:05.000000Z",
  "updated_at": "2026-02-10T13:39:24.000000Z"
}

404 Not Found / Wrong Owner

Response

{
  "error": "Message not found"
}

Delete Message

DELETE /api/message/{id}/{key}

Delete a message by ID. You must prove ownership by providing the email and password.

URL Parameters

id integer Message ID required

key string API key required

Query Parameters

email string Email address (owner) required

password string Password required

200 Success

Response

{
  "success": true
}

404 Not Found / Wrong Owner

Response

{
  "error": "Message not found"
}

401 Invalid Credentials

Response

{
  "error": "Invalid email or password"
}