API Reference

Temporary Mail API

Programmatic disposable email. Generate addresses, poll inboxes, and read messages — no auth required. Base URL: https://bigsummerdeal.com

POST/api/generate

Generate a new disposable email address.

Request

No body required.

Response

{
  "email": "a1b2c3d4e5@bigsummerdeal.com",
  "expiresAt": "2026-08-25T09:48:29.378Z"
}

Example

curl -X POST https://bigsummerdeal.com/api/generate

POST/api/inbox

Open (or create) an inbox for any address under your domain.

Request

{ "address": "myusername" } // or full: "myusername@bigsummerdeal.com"

Response

{
  "inbox": { "email": "myusername@bigsummerdeal.com", "messages": [] }
}

Example

curl -X POST https://bigsummerdeal.com/api/inbox \
  -H "Content-Type: application/json" \
  -d '{ "address": "myusername" }'

GET/api/inbox/:email

Fetch all messages for an inbox (with sender, subject, body).

Request

Path param: full email address (URL-encoded).

Response

{
  "inbox": {
    "email": "a1b2c3d4e5@bigsummerdeal.com",
    "expiresAt": "2026-08-25T09:48:29.378Z",
    "messages": [
      {
        "id": "63a2438d-...",
        "from": "sender@example.com",
        "to": "a1b2c3d4e5@bigsummerdeal.com",
        "subject": "Your code is 123456",
        "text": "Plain text body...",
        "html": "<p>HTML body...</p>",
        "date": "2026-08-24T09:45:49.859Z"
      }
    ]
  }
}

Example

curl https://bigsummerdeal.com/api/inbox/a1b2c3d4e5@bigsummerdeal.com

DELETE/api/inbox/:email

Delete an inbox and all its messages immediately.

Request

Path param: full email address.

Response

{ "success": true }

Example

curl -X DELETE https://bigsummerdeal.com/api/inbox/a1b2c3d4e5@bigsummerdeal.com

GET/api/message/:id

Fetch a single message by its ID.

Request

Path param: message ID from the inbox response.

Response

{
  "message": {
    "id": "63a2438d-...",
    "from": "sender@example.com",
    "subject": "Your code is 123456",
    "text": "Plain text body...",
    "html": "<p>HTML body...</p>",
    "date": "2026-08-24T09:45:49.859Z"
  }
}

Example

curl https://bigsummerdeal.com/api/message/63a2438d-...

Notes

Inboxes auto-expire after 4 hours. Expired inboxes are deleted automatically.
Rate limits: All endpoints are limited to 30 requests per minute per IP. Pass X-API-Key header to bypass all limits.
Messages are stored in memory — they are cleared on server restart.
Each inbox keeps at most the 50 most recent messages.
Incoming email is received via @bigsummerdeal.com and forwarded to your inbox automatically.