TempMail API Documentation

Get temporary email addresses and read emails with our simple API

Overview

This API allows you to create temporary email addresses and read emails sent to them. Each operation costs 0.002 USD and emails are available for 6 hours.

Cost: 0.002 USD per email

Duration: 6 hours

Security: Only you can read your emails

API Key

All requests require a valid API key. You can get your API key from your account page.

x-api-key: your_api_key

Get Mailbox - Get Temporary Email

GET https://roketemail.com/tempmail

Query Parameters

type string required

Email type - only "hotmail" and "outlook" are supported

quantity integer required

Number of emails to get (default: 1)

x-api-key string required

Your API key

Request Example

curl -X GET "https://roketemail.com/tempmail?type=hotmail&quantity=1&x-api-key=your_api_key"

Success Response

{
    "ok": true,
    "email": "mantinihoneysuckle3382@hotmail.com",
    "list": ["mantinihoneysuckle3382@hotmail.com"]
}

Error Responses

Insufficient Balance:

{"success": false, "error": "Yetersiz bakiye"}

Invalid API Key:

{"success": false, "error": "Geçersiz API key"}

Read Emails - Read Email Inbox

GET https://roketemail.com/tempmail

Query Parameters

email string required

The email address you want to read (must be one you created)

x-api-key string required

Your API key

Request Example

curl -X GET "https://roketemail.com/tempmail?email=your_email@hotmail.com&x-api-key=your_api_key"

Success Response

{
    "ok": true,
    "data": {
        "account": "your_email@hotmail.com",
        "inboxData": [
            {
                "id": "msg_12345",
                "from": "sender@example.com",
                "subject": "Test Email",
                "date": "2024-01-01T12:00:00Z"
            }
        ]
    }
}

Error Responses

Email Expired:

{"success": false, "error": "Bu emaili okuyamazsınız, üzerinden 6 saat geçmiştir"}

Email Not Yours:

{"success": false, "error": "Bu email size ait değil veya bulunamadı"}

Read Email Content - Get Email HTML Content

GET https://roketemail.com/tempmail

Query Parameters

email string required

The email address (must be one you created)

message_id string required

The message ID from the inbox data

x-api-key string required

Your API key

Request Example

curl -X GET "https://roketemail.com/tempmail?email=your_email@hotmail.com&message_id=msg_12345&x-api-key=your_api_key"

Success Response

{
    "ok": true,
    "html": "<html><body>Email content here...</body></html>"
}

Error Responses

Email Expired:

{"success": false, "error": "Bu emaili okuyamazsınız, üzerinden 6 saat geçmiştir"}

Email Not Yours:

{"success": false, "error": "Bu email size ait değil veya bulunamadı"}

Important Notes

Cost: Each email request costs 0.002 USD
Duration: Emails are available for 6 hours
Security: You can only read emails you created
Error Messages: All errors return "RoketAPI hata verdi, az sonra tekrar deneyin"

Usage Tips

Keep your API key secure and never share it
You can create new API keys from your account page
Emails expire after 6 hours, make sure to read them in time
Each email request will deduct 0.002 USD from your balance