API Documentation - Cheapluxury TempMail

GET Get Domains

Retrieve all available email domains for registration.

Endpoint

/domains

Response (200 OK)

{
  "response_code": 200,
  "data": {
    "domains": [
      "example.com",
      "tempmail.com",
      "cheapluxury.eu"
    ]
  }
}

Code Examples

curl -X GET ${window.location.origin}/domains

const response = await fetch('${window.location.origin}/domains');

const data = await response.json();
console.log(data.data.domains);

import requests

response = requests.get('${window.location.origin}/domains')

data = response.json()
print(data['data']['domains'])

Interactive Test

Response:

POST Register User

Create a new temporary email account.

Endpoint

/register

Request Body

{
  "email": "[email protected]",
  "password": "SecurePass123"
}

Password must be at least 8 characters with uppercase, lowercase, and digit

Response (201 Created)

{
  "response_code": 201,
  "message": "Registration successful",
  "data": {
    "email": "[email protected]"
  }
}

Code Examples

curl -X POST ${window.location.origin}/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "SecurePass123"
  }'

const response = await fetch('${window.location.origin}/register', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: '[email protected]',
    password: 'SecurePass123'
  })
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    '${window.location.origin}/register',
    json={
        'email': '[email protected]',
        'password': 'SecurePass123'
    }
)

data = response.json()
print(data)

Interactive Test

Email Address

Password

Response:

GET Generate Random Email

Quick generate a random temporary email address with credentials.

Endpoint

/random_email

Response (200 OK)

{
  "response_code": 200,
  "message": "Random email generated successfully",
  "data": {
    "email": "[email protected]",
    "password": "SecurePass789"
  }
}

Code Examples

curl -X GET ${window.location.origin}/random_email

const response = await fetch('${window.location.origin}/random_email');

const data = await response.json();
console.log(data.data);

import requests

response = requests.get('${window.location.origin}/random_email')

data = response.json()
print(data['data'])

Interactive Test

Response:

POST Login User

Authenticate and retrieve your temporary email address.

Endpoint

/login

Request Body

{
  "email": "[email protected]",
  "password": "SecurePass123"
}

Response (200 OK)

{
  "response_code": 200,
  "message": "Login successful",
  "data": {
    "emails": [
      {
        "id": 67890,
        "from_addr": "[email protected]",
        "to_addr": "[email protected]",
        "subject": "Welcome!",
        "date": "2025-11-29T10:35:00",
        "body_text": "Thank you for signing up...",
        "body_html": "...",
        "inline_images": {},
        "has_attachments": false,
        "size": 1234,
        "flags": [],
        "message_id": "",
        "in_reply_to": null,
        "references": null
      }
    ]
  }
}

Code Examples

curl -X POST ${window.location.origin}/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "SecurePass123"
  }'

const response = await fetch('${window.location.origin}/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: '[email protected]',
    password: 'SecurePass123'
  })
});

const data = await response.json();
console.log(data.data.emails);

import requests

response = requests.post(
    '${window.location.origin}/login',
    json={
        'email': '[email protected]',
        'password': 'SecurePass123'
    }
)

data = response.json()
print(data['data']['emails'])

Interactive Test

Email Address

Password

Response:

POST Get Emails

Retrieve all emails for your temporary email address.

Endpoint

/email/get

Request Body

{
  "email": "[email protected]",
  "password": "SecurePass123"
}

Response (200 OK)

{
  "response_code": 200,
  "message": "Emails retrieved successfully",
  "data": {
    "emails": [
      {
        "id": 67890,
        "from_addr": "[email protected]",
        "to_addr": "[email protected]",
        "subject": "Welcome!",
        "date": "2025-11-29T10:35:00",
        "body_text": "Thank you for signing up...",
        "body_html": "...",
        "inline_images": {},
        "has_attachments": false,
        "size": 1234,
        "flags": [],
        "message_id": "",
        "in_reply_to": null,
        "references": null
      }
    ]
  }
}

Code Examples

curl -X POST ${window.location.origin}/email/get \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "SecurePass123"
  }'

const response = await fetch('${window.location.origin}/email/get', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: '[email protected]',
    password: 'SecurePass123'
  })
});

const data = await response.json();
console.log(data.data.emails);

import requests

response = requests.post(
    '${window.location.origin}/email/get',
    json={
        'email': '[email protected]',
        'password': 'SecurePass123'
    }
)

data = response.json()
print(data['data']['emails'])

Interactive Test

Email Address

Password

Response:

POST View Specific Email

Retrieve a specific email by its Message-ID.

Endpoint

/email/view

Request Body

{
  "email": "[email protected]",
  "password": "SecurePass123",
  "message_id": ""
}

Response (200 OK)

{
  "response_code": 200,
  "message": "Email retrieved successfully",
  "data": {
    "email": {
      "message_id": "",
      "from_addr": "[email protected]",
      "to_addr": "[email protected]",
      "subject": "Welcome!",
      "date": "2025-11-29T10:35:00",
      "body_text": "Thank you for signing up...",
      "body_html": "...",
      "inline_images": {},
      "has_attachments": false,
      "size": 1234,
      "flags": [],
      "in_reply_to": null,
      "references": null
    }
  }
}

Code Examples

curl -X POST ${window.location.origin}/email/view \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "SecurePass123",
    "message_id": ""
  }'

const response = await fetch('${window.location.origin}/email/view', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: '[email protected]',
    password: 'SecurePass123',
    message_id: ''
  })
});

const data = await response.json();
console.log(data.data.email);

import requests

response = requests.post(
    '${window.location.origin}/email/view',
    json={
        'email': '[email protected]',
        'password': 'SecurePass123',
        'message_id': ''
    }
)

data = response.json()
print(data['data']['email'])

Interactive Test

Email Address

Password

Message ID

Introduction

Base URL

Response Format

Rate Limit

GET Get Domains

Endpoint

Response (200 OK)

Code Examples

Interactive Test

Response:

POST Register User

Endpoint

Request Body

Response (201 Created)

Code Examples

Interactive Test

Response:

GET Generate Random Email

Endpoint

Response (200 OK)

Code Examples

Interactive Test

Response:

POST Login User

Endpoint

Request Body

Response (200 OK)

Code Examples

Interactive Test

Response:

POST Get Emails

Endpoint

Request Body

Response (200 OK)

Code Examples

Interactive Test

Response:

POST View Specific Email

Endpoint

Request Body

Response (200 OK)

Code Examples

Interactive Test

Response:

Error Responses