English documentation for API URLs: create temporary mailboxes, list inbox messages, and read email content.
https://tempmailapi.io.vn https://tempmailvip.online
Log in, open the API button, then generate an API key.
Header: X-API-Key: YOUR_API_KEY Query: ?api_key=YOUR_API_KEY
Do not share your real API key in screenshots or logs.
There is no daily limit anymore. The API only uses per-minute and per-hour limits for regular users. Admin users are unlimited.
| Window | Limit |
|---|---|
| Per minute | 300 requests |
| Per hour | 10,000 requests |
X-API-Usage-Minute: current/300 X-API-Usage-Hour: current/10000
Returns available domains. No API key required.
curl "https://tempmailapi.io.vn/public_api.php?action=domains"
{"success":true,"domains":["tempmailapi.io.vn","apponi.site"]}| Parameter | Required | Description |
|---|---|---|
| api_key | Yes | Your API key |
| user | No | Email username; omitted means random |
| domain | No | Domain to create the mailbox on |
curl -X GET "https://tempmailapi.io.vn/public_api.php?action=create&api_key=YOUR_API_KEY&user=mytest&domain=apponi.site" \ -H "X-API-Key: YOUR_API_KEY"
{"success":true,"email":"mytest@apponi.site","password":"STRONG_PASSWORD"}| Parameter | Required | Description |
|---|---|---|
| api_key | Yes | Your API key |
| Yes | Full email address | |
| limit | No | Maximum messages, up to 50 |
curl "https://tempmailapi.io.vn/public_api.php?action=list&api_key=YOUR_API_KEY&email=mytest@apponi.site&limit=20" \ -H "X-API-Key: YOUR_API_KEY"
{"success":true,"emails":[{"id":1,"uid":42,"position":1,"from":"sender@example.com","subject":"OTP"}],"total":1}| Parameter | Required | Description |
|---|---|---|
| api_key | Yes | Your API key |
| Yes | Full email address | |
| id | No | ID from list or 1-based position |
| uid | No | Stable message UID |
| email_id | No | Alias of id for older clients |
curl "https://tempmailapi.io.vn/public_api.php?action=read&api_key=YOUR_API_KEY&email=mytest@apponi.site&uid=42" \ -H "X-API-Key: YOUR_API_KEY"
{"success":true,"email":{"id":1,"uid":42,"position":1,"subject":"OTP","body_text":"...","body_html":"..."}}| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Invalid parameter or domain not allowed |
| 401 | Missing or invalid API key |
| 429 | Rate limit exceeded |
| 500 | Server error |