Temp-Mail API

Generate temporary email addresses and check received messages with our powerful API. Perfect for testing, verification, or protecting your privacy online.

To access the Temp-Mail API, sign in with Google to generate your unique API key. This key will allow you to make requests to our API and retrieve movie and TV series data.

Create Temporary Email

Generate a new temporary email address. Make a GET request to the following endpoint:

https://api.skymansion.site/temp-mail/create?api_key={your_api_key}

Parameters

api_key (required): Your unique API key for authentication.

Example Request

https://api.skymansion.site/temp-mail/create?api_key=your_api_key

Example Response

{
    "code": 200,
    "email": "temp-mail@temp-mail.com",
    "powered-by": "skymansion.site",
    "script-by": "Rasanjana Piumal Senadeera"
}

Response Fields

code: HTTP status code (200 for success).
email: The generated temporary email address.
powered-by: API provider information.
script-by: Developer credit.

Check Received Messages

Retrieve messages sent to a temporary email address. Make a GET request to the following endpoint:

https://api.skymansion.site/temp-mail/messages?email={email}&api_key={your_api_key}

Parameters

email (required): The temporary email address to check
api_key (required): Your unique API key for authentication

Example Request

https://api.skymansion.site/temp-mail/messages?email=temp-mail@temp-mail.com&api_key=your_api_key

Example Response

{
    "code": 200,
    "messages": [
        {
            "id": "a68ab986-626c-49f3-b0cf-e18f64fe7f03",
            "from": "\"Sender Name\" <sender@example.com>",
            "to": "temp-mail@temp-mail.com",
            "cc": null,
            "subject": "Test Message",
            "body_text": "This is a test message\n",
            "body_html": "<div>This is a test message</div>",
            "created_at": "2025-04-06T19:16:55.27615Z",
            "attachments": []
        }
    ],
    "powered-by": "skymansion.site",
    "script-by": "Rasanjana Piumal Senadeera"
}

Response Fields

code: HTTP status code (200 for success).
messages: Array of message objects.
powered-by: API provider information.
script-by: Developer credit.

Rate Limits

The Temp-Mail API has the following rate limits:

3 email creations per day per API key
Unlimited message checks for existing email addresses

Example Error Response

{
  "error": "Limit exceeded. Try again tomorrow."
}

Increase Rate Limit

Need more than requests per day? Contact us to increase your rate limit.

Contact: +94 72 525 7970