Temp Mail API Documentation
Integrate our temporary email generator directly into your applications. The API is free to use and provides access to premium.edu.pl and.org.uk domains.
Base URL: https://api.edu-mails.com/api
GET /domains
Retrieve a list of all currently active educational domains that can be used to generate custom emails. Use ?tld=.org.uk to fetch.org.uk domains.
Response Example:
{
"status": "success",
"data": {
"domains": [
{
"id": 1,
"name": "cambrigeuni.edu.pl",
"tld": ".edu.pl"
}
]
}
}
POST /emails/generate
Generate a new temporary email address. You can generate a random address or request a custom username on a specific domain.
Parameters (JSON body):
action(string) - Set to"random"or"custom".alias(string) - (Only for custom) The requested username prefix.domain_id(integer) - (Only for custom) The ID of the domain fetched from /domains.
Request Example (Custom):
{
"action": "custom",
"alias": "student2026",
"domain_id": 1
}
Response Example:
{
"status": "success",
"data": {
"email": {
"uuid": "4f92..a31c",
"address": "student2026@cambrigeuni.edu.pl",
"created_at": "2026-06-17T15:00:00.000000Z"
}
}
}
Save the uuid from the response to fetch messages later.
GET /emails/{uuid}
Fetch the inbox contents for a specific email address using its UUID.
Response Example:
{
"status": "success",
"data": {
"email": {
"uuid": "..",
"address": "student2026@cambrigeuni.edu.pl"
},
"messages": [
{
"id": 12,
"from": "GitHub ",
"subject": "Verify your email address",
"text_body": "Please click the link below..",
"html_body": "<html>..</html>",
"created_at": "2026-06-17T15:05:00.000000Z"
}
]
}
}