API documentation

When not carrying the Key, you can make anonymous calls from a guest account. Generating and accessing temporary emails is completely free of charge. If you have purchased a package that includes API functionality, you can generate your own API Key in the Member Center → Developers section. Using this Key for calls will allow you to benefit from the saved quota and retention period offered by the corresponding package.

Carrying method (choose one of the two options)

request example

curl "https://www.mail0.vip/mail/gen?key=YOUR_API_KEY"

A temporary email address is generated randomly. This address can be used to receive messages, without the need for any prior activation steps.

request parameters

request example

curl "https://www.mail0.vip/mail/gen?domain=ideciphera.com&ttl=60"

Response example

{
  "code": 1,
  "address": "k3j8fh2ma@ideciphera.com"
}

Enable an address with a custom prefix (prefix@domain name), and verify whether the domain name is accessible for receiving messages.

request parameters

request example

curl -X POST "https://www.mail0.vip/mail/activate" \
  -d "address=mybox@ideciphera.com&ttl=60"

Response example

{
  "code": 1,
  "address": "mybox@ideciphera.com"
}

Fetch the inbox from the specified address (last 50 messages, ordered in reverse order of receipt time). It is recommended to poll every 1–3 seconds.

request parameters

request example

curl "https://www.mail0.vip/mail/inbox?address=mybox@ideciphera.com"

Response example

{
  "code": 1,
  "exists": 1,
  "address": "mybox@ideciphera.com",
  "list": [
    {
      "id": 1024,
      "from_addr": "noreply@example.com",
      "from_name": "Example",
      "subject": "Your verification code is 826413",
      "size": 2048,
      "is_read": 0,
      "attachments": 0,
      "received_at": "2026-10-14 18:20:31"
    }
  ]
}

View the details of the email (sender, subject, body, attachment list). After viewing, the email will be marked as read.

request parameters

request example

curl "https://www.mail0.vip/mail/view?address=mybox@ideciphera.com&id=1024"

Response example

{
  "code": 1,
  "data": {
    "id": 1024,
    "from_addr": "noreply@example.com",
    "from_name": "Example",
    "subject": "Your verification code is 826413",
    "body_text": "Dear user, your verification code is 826413, valid for 5 minutes.",
    "received_at_fmt": "2026-10-14 18:20:31",
    "attachments": [
      { "id": 88, "filename": "invoice.pdf", "size": 102400 }
    ]
  }
}

Download the email attachment (the file is sent as a stream, not in JSON format).

request parameters

request example

curl -O "https://www.mail0.vip/mail/attach?id=88"

Save an address to your account for long-term retention (requires login or possession of an API key). The number of addresses that can be saved is limited by the “Number of Email Addresses Saved” parameter in your subscription.

request parameters

request example

curl -X POST "https://www.mail0.vip/mail/save" \
  -d "address=mybox@ideciphera.com&key=YOUR_API_KEY"

List the email addresses that have been saved under your account. You need to log in or possess an API key to access this information.

request example

curl "https://www.mail0.vip/mail/my?key=YOUR_API_KEY"

The following script can be executed directly in the browser console or in a Node.js environment: it generates an address, polls the inbox, and prints the verification code as soon as the first email is received.

// 1. Generate a temporary address
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('My temporary email address:', address);

// 2. Polling of the inbox (occurs every 2 seconds; stops once the first message is received)
const seen = new Set();
while (true) {
  const d = await (await fetch(BASE + '/mail/inbox?address=' + encodeURIComponent(address))).json();
  for (const m of d.list || []) {
    if (seen.has(m.id)) continue;
    seen.add(m.id);
    const code = (m.subject || '').match(/\d{4,8}/);
    console.log('New emails:', m.subject, code ? 'Captcha ' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}