API Documentation

Use the API to create temporary email addresses, list received messages, read message details, delete messages, and download raw emails or attachments.

Base URL: https://mail.minecraft-cn.net

List Available Domains

curl https://mail.minecraft-cn.net/api/v1/domains

Create Email Address

curl -X POST https://mail.minecraft-cn.net/api/v1/addresses
curl -X POST https://mail.minecraft-cn.net/api/v1/addresses \
  -H "Content-Type: application/json" \
  -d '{"username":"test123","domain":"microsoft-cn.net"}'

The response includes an email address and a private token. Keep the token because it is required to read that inbox.

List Emails

curl https://mail.minecraft-cn.net/api/v1/{token}/emails
curl "https://mail.minecraft-cn.net/api/v1/{token}/emails?page=1&per_page=50"

Read Email Detail

curl https://mail.minecraft-cn.net/api/v1/{token}/emails/{email_id}

Download Attachments Or Raw Email

curl -O https://mail.minecraft-cn.net/api/v1/{token}/emails/{email_id}/attachments/{attachment_id}
curl -O https://mail.minecraft-cn.net/api/v1/{token}/emails/{email_id}/raw

Delete Email

curl -X DELETE https://mail.minecraft-cn.net/api/v1/{token}/emails/{email_id}

Browser Usage

GET endpoints can be opened directly in a browser. POST and DELETE requests should be sent with curl, fetch, Postman, or another HTTP client.