Get an email
curl --request GET \
--url https://api.tempmaillab.com/v1/emails/{email_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.tempmaillab.com/v1/emails/{email_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.tempmaillab.com/v1/emails/{email_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tempmaillab.com/v1/emails/{email_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"data": {
"id": "<string>",
"address": "jsmith@example.com",
"local_part": "<string>",
"domain": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "invalid_api_key",
"message": "A valid API key is required.",
"request_id": "req_a1b2c3d4e5f6g7h8"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": [
{
"reason": "<string>",
"field": "<string>"
}
]
}
}{
"error": {
"code": "resource_not_found",
"message": "The requested resource was not found.",
"request_id": "req_a1b2c3d4e5f6g7h8"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Retry after the indicated delay.",
"request_id": "req_a1b2c3d4e5f6g7h8"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": [
{
"reason": "<string>",
"field": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": [
{
"reason": "<string>",
"field": "<string>"
}
]
}
}Get an email
Returns an email owned by the authenticated account. Expired resources are not revived. An absent, expired, or unauthorized resource is represented by the same 404 shape to reduce enumeration. A 304 response is still charged.
GET
/
v1
/
emails
/
{email_id}
Get an email
curl --request GET \
--url https://api.tempmaillab.com/v1/emails/{email_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.tempmaillab.com/v1/emails/{email_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.tempmaillab.com/v1/emails/{email_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tempmaillab.com/v1/emails/{email_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"data": {
"id": "<string>",
"address": "jsmith@example.com",
"local_part": "<string>",
"domain": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "invalid_api_key",
"message": "A valid API key is required.",
"request_id": "req_a1b2c3d4e5f6g7h8"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": [
{
"reason": "<string>",
"field": "<string>"
}
]
}
}{
"error": {
"code": "resource_not_found",
"message": "The requested resource was not found.",
"request_id": "req_a1b2c3d4e5f6g7h8"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Retry after the indicated delay.",
"request_id": "req_a1b2c3d4e5f6g7h8"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": [
{
"reason": "<string>",
"field": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": [
{
"reason": "<string>",
"field": "<string>"
}
]
}
}Authorizations
Send a live API key in the Authorization header. Keys in query strings are rejected. A staging key never authenticates against production.
Headers
Return 304 when the current representation matches this entity tag.
Path Parameters
Opaque email identifier. The address itself is never used as a path ID.
Pattern:
^eml_[A-Za-z0-9_-]{10,64}$Example:
"eml_4p9g2t7n8w"
Response
Email details.
Show child attributes
Show child attributes
Last modified on August 8, 2026
⌘I