ZoroMail
Developer API

ZoroMail API

A simple REST API to generate disposable email addresses and read incoming mail from your own apps and scripts. All responses are JSON and no API key is required.

Base URL https://zoromail.com/public_api.php/v1

Overview

Every endpoint returns a JSON envelope with a consistent shape. Check the success flag before reading data. 

{
  "success": true,
  "data": { ... },
  "error": null
}
1

List Domains

Retrieve a list of available email domains.

Endpoint
GET https://zoromail.com/public_api.php/v1/domains
Example response
{
  "success": true,
  "data": [ "zoromail.com", "aesa.foo" ],
  "error": null
}
2

Create Email

Create a new disposable email address. Provide a username and optionally a domain (a random available domain is used if omitted).

Endpoint
POST https://zoromail.com/public_api.php/v1/emails
Request body
{ "username": "test123", "domain": "zoromail.com" }
Example (cURL)
curl -X POST https://zoromail.com/public_api.php/v1/emails \
  -H "Content-Type: application/json" \
  -d '{"username":"test123","domain":"zoromail.com"}'
Example response
{
  "success": true,
  "data": { "email": "test123@zoromail.com" },
  "error": null
}
3

Fetch Messages

Retrieve all messages received by an email address.

Endpoint
GET https://zoromail.com/public_api.php/v1/emails/[email]/messages
Example
https://zoromail.com/public_api.php/v1/emails/test123@zoromail.com/messages
Example response
{
  "success": true,
  "data": [
    {
      "id": "12345",
      "from": "noreply@service.com",
      "subject": "Your verification code",
      "date": "2026-06-07T10:04:00Z"
    }
  ],
  "error": null
}
4

Read Message

Fetch the full body of a single message by its ID.

Endpoint
GET https://zoromail.com/public_api.php/v1/messages/[message_id]
Example
https://zoromail.com/public_api.php/v1/messages/12345
5

Delete Message

Delete a specific message by its ID.

Endpoint
DELETE https://zoromail.com/public_api.php/v1/messages/[message_id]
Example (cURL)
curl -X DELETE https://zoromail.com/public_api.php/v1/messages/12345
Example response
{
  "success": true,
  "data": { "deleted": "12345" },
  "error": null
}