TMail API Documentation

rocket_launch

Getting Started

Welcome to TMail API documentation. This REST API allows you to programmatically manage temporary email inboxes. All endpoints require API Key authentication.

link Base URL


              https://egzz.lat/api

format_quote Response Format

All responses are in JSON format with consistent structure.

vpn_key

Authentication

API Key must be included in the URL path for all requests. Keep your API key secure and never expose it in client-side code.

API_KEY = "your_api_key_here"

warning

Security Notice

Your API Key grants full access to your account. Do not share it publicly or commit it to version control systems.

inbox

GET

Create / Get Inbox

Creates a new inbox or retrieves existing inbox data

link

Endpoint

https://egzz.lat/api/email/{email}/{api_key}

tune Parameters

Parameter	Type	Required	Description
`email`	string	Required	Email address for the inbox
`api_key`	string	Required	Your API key for authentication

Code Examples

curl -X GET "https://egzz.lat/api/email/test@mail.egzz/API_KEY"
-H "Accept: application/json"

fetch("https://egzz.lat/api/email/test@mail.egzz/API_KEY")
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

url = "https://egzz.lat/api/email/test@mail.egzz/API_KEY"
response = requests.get(url)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")

assignment_returned Response

Success 200 When inbox is successfully created or retrieved

{
  "status": true,
  "message": "Inbox ready",
  "data": {
    "email": "test@mail.egzz",
    "inbox_id": "INBOX_9f3a2c",
    "created_at": "2026-01-06 14:40:12",
    "expires_at": "2026-01-07 14:40:12"
  }
}

mail

GET

Get Messages

Retrieve all messages from a specific inbox

link

Endpoint

https://egzz.lat/api/messages/{email}/{api_key}

tune Parameters

Parameter	Type	Required	Description
`email`	string	Required	Email address of the inbox
`api_key`	string	Required	Your API key for authentication

Code Examples

curl -X GET "https://egzz.lat/api/messages/test@mail.egzz/API_KEY"
-H "Accept: application/json"

fetch("https://egzz.lat/api/messages/test@mail.egzz/API_KEY")
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

url = "https://egzz.lat/api/messages/test@mail.egzz/API_KEY"
response = requests.get(url)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")

assignment_returned Response

Success 200 When messages are retrieved successfully

{
  "status": true,
  "message": "Messages retrieved",
  "data": [
    {
      "id": "msg_abc123",
      "from": "sender@example.com",
      "subject": "Welcome to our service",
      "preview": "Thank you for registering...",
      "received_at": "2026-01-06 14:40:12",
      "read": false
    },
    {
      "id": "msg_def456",
      "from": "noreply@company.com",
      "subject": "Password Reset Request",
      "preview": "Click here to reset your password...",
      "received_at": "2026-01-06 14:35:10",
      "read": true
    }
  ]
}

description

GET

Get Message Detail

Retrieve detailed information about a specific message

link

Endpoint

https://egzz.lat/api/message/{message_id}/{api_key}

tune Parameters

Parameter	Type	Required	Description
`message_id`	string	Required	Unique ID of the message
`api_key`	string	Required	Your API key for authentication

Code Examples

curl -X GET "https://egzz.lat/api/message/msg_abc123/API_KEY"
-H "Accept: application/json"

fetch("https://egzz.lat/api/message/msg_abc123/API_KEY")
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

url = "https://egzz.lat/api/message/msg_abc123/API_KEY"
response = requests.get(url)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")

assignment_returned Response

Success 200 When message details are retrieved successfully

{
  "status": true,
  "message": "Message retrieved",
  "data": {
    "id": "msg_abc123",
    "from": "sender@example.com",
    "to": "test@mail.egzz",
    "subject": "Welcome to our service",
    "body": "Thank you for registering...",
    "html_body": "Thank you for registering...",
    "attachments": [],
    "received_at": "2026-01-06 14:40:12",
    "read": true
  }
}

delete

DELETE

Delete Message

Permanently delete a specific message from the inbox

link

Endpoint

https://egzz.lat/api/message/{message_id}/{api_key}

tune Parameters

Parameter	Type	Required	Description
`message_id`	string	Required	Unique ID of the message to delete
`api_key`	string	Required	Your API key for authentication

Code Examples

curl -X DELETE "https://egzz.lat/api/message/msg_abc123/API_KEY"
-H "Accept: application/json"

fetch("https://egzz.lat/api/message/msg_abc123/API_KEY", {
  method: 'DELETE',
  headers: {
    'Accept': 'application/json'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

import requests

url = "https://egzz.lat/api/message/msg_abc123/API_KEY"
response = requests.delete(url)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")

assignment_returned Response

Success 200 When message is successfully deleted

{
  "status": true,
  "message": "Message deleted successfully",
  "data": {
    "deleted_id": "msg_abc123",
    "deleted_at": "2026-01-06 14:45:30"
  }
}