A clean, well-documented REST API to generate inboxes, receive messages, and parse verification codes — all from your own application.
All API requests must include your API key as a query parameter: ?key=YOUR_API_KEY. You can generate your key from the Premium dashboard.
# Include your key with every request GET https://api.TempMail.vcnclgatd.site/v1/generate?key=YOUR_API_KEY
All API requests are made over HTTPS to the following base URL. HTTP requests will be redirected to HTTPS.
https://api.TempMail.vcnclgatd.site/v1
| Plan | Requests / min | Requests / day | Concurrent inboxes |
|---|---|---|---|
| Free | 10 | 500 | 1 |
| Premium | 120 | 50,000 | Unlimited |
| Code | Meaning |
|---|---|
| 400 | Bad Request — missing or malformed parameters |
| 401 | Unauthorized — invalid or missing API key |
| 404 | Not Found — address or message does not exist |
| 429 | Too Many Requests — rate limit exceeded |
| 500 | Server Error — retry with exponential back-off |
Creates a new temporary email address. Optionally specify a custom domain (Premium) or TTL.
| Name | Type | Required | Description |
|---|---|---|---|
| key | string | required | Your API key |
| domain | string | optional | Custom domain (Premium only) |
| ttl | integer | optional | Address lifetime in seconds (default: 3600) |
curl -X GET "https://api.TempMail.vcnclgatd.site/v1/generate_email.php?key=vcncawuz123&ttl=3600"
{
"email": "k9x2m7@TempMail.vcnclgatd.site",
"expires_at": "2026-03-07T14:00:00Z",
"ttl": 3600
}
Returns all messages received by a disposable address. Poll this endpoint or use WebSockets for real-time delivery.
| Name | Type | Required | Description |
|---|---|---|---|
| key | string | required | Your API key |
| string | required | The disposable address to check |
curl -X GET "https://api.TempMail.vcnclgatd.site/v1/inbox.php?key=vcncawuz123&email=k9x2m7@TempMail.vcnclgatd.site"
[
{
"id": "msg_a1b2c3",
"sender": "noreply@github.com",
"subject": "Verify your email address",
"date_received": "2026-03-07T13:05:22Z"
}
]
Returns the full content of a message, including the parsed OTP code or verification link if detected.
| Name | Type | Required | Description |
|---|---|---|---|
| key | string | required | Your API key |
| string | required | The disposable address | |
| id | string | required | Message ID from the inbox endpoint |
{
"id": "msg_a1b2c3",
"sender": "noreply@github.com",
"subject": "Verify your email address",
"date_received": "2026-03-07T13:05:22Z",
"body": "<p>Click to verify...</p>",
"otp": null,
"confirmation_link": "https://github.com/verify?token=abc123"
}
Permanently deletes a disposable address and all associated messages before the natural expiry time.
| Name | Type | Required | Description |
|---|---|---|---|
| key | string | required | Your API key |
| string | required | The address to delete |
{ "deleted": true, "email": "k9x2m7@TempMail.vcnclgatd.site" }