API Documentation

Simple REST API for your integrations.

Authentication
Header: X-API-Key: YOUR_API_KEY
Free endpoints work without a key but are heavily rate-limited.
GET /api/v1/domains

List all public domains.

Response
{
  "success": true,
  "domains": [
    { "domain": "kufz.minhaishop.click", "status": "online" }
  ]
}
POST /api/v1/generate

Generate a new temporary email.

Body
{ "domain": "kufz.minhaishop.click" }
Response
{
  "success": true,
  "email": "laurenbk8j40lzf@kufz.minhaishop.click",
  "url": "https://mail.cloudhoatoc.com/laurenbk8j40lzf@kufz.minhaishop.click"
}
GET /api/v1/inbox?email={email}

Fetch all messages for a temporary email.

Response
{
  "success": true,
  "total": 1,
  "messages": [
    {
      "id": 1,
      "from": "noreply@example.com",
      "subject": "Your verification code",
      "code_2fa": "123456",
      "received_at": "2026-04-27 15:30:00"
    }
  ]
}
GET /api/v1/message?id={id}

Get full content of a single message.

Response
{ "success": true, "message": { "id": 1, "body_html": "...", "body_text": "..." } }
POST /api/v1/add-domain

Submit a custom domain for verification.

Body
{ "domain": "example.com", "webhook_url": "https://..." }
Response
{ "success": true, "status": "pending" }
Webhook payload (new email)
{
  "event": "new_email",
  "email": "laurenbk8j40lzf@kufz.minhaishop.click",
  "from": "service@example.com",
  "subject": "Your verification code",
  "code": "123456",
  "received_at": "2026-04-27 15:30:00"
}
cURL Examples
List domains
curl -X GET "https://mail.cloudhoatoc.com/api/v1/domains"
Generate email
curl -X POST "https://mail.cloudhoatoc.com/api/v1/generate" \
  -H "Content-Type: application/json" \
  -d '{"domain":"kufz.minhaishop.click"}'
Check inbox (with API key)
curl -X GET "https://mail.cloudhoatoc.com/api/v1/inbox?email=test@kufz.minhaishop.click" \
  -H "X-API-Key: tmk_live_YOUR_KEY"