Developer API
REST JSON API for disposable inboxes, Free/Premium plan features, restore tokens, and history. Interactive docs: /docs
GET /api/plans
Smailpro-style feature matrix (Free vs Premium) + domain pools.
GET /api/domains?plan=free&pool=temp
Domains for a plan + pool. Pools: temp, edu, gmail, outlook.
POST /api/email
{
"domain": "tempmail.local",
"local": "optional-name",
"ttl": 3600,
"plan": "free",
"pool": "temp",
"mode": "random",
"alias_base": "user",
"active_count": 0
}
Modes: random · sequential (Premium) · alias (Premium).
Response includes restore_token.
POST /api/restore
{ "token": "…", "seconds": 3600 }
Restore anytime by token (Premium-style).
GET /api/history?plan=premium&limit=50
Server history (Premium 500). Free → localStorage only (50).
GET /api/emails/{address}
List messages. Optional: ?q=search.
GET /api/emails/{address}/{id}
Full message body.
DELETE /api/emails/{address}
Destroy mailbox.
POST /api/demo/sample/{address}
Inject sample emails for UI testing.