Get Message List

Get all messages in the specified email address.

Request

GET /api/emails/{emailId}

Request Parameters

Parameter	Type	Required	Description
emailId	string	Yes	Email ID (path parameter)
cursor	string	No	Pagination cursor (query parameter), get nextCursor from previous response

Request Example

curl "https://chat-tempmail.com/api/emails/c2c4f894-c672-4d5b-a918-abca95aff1f7" \
  -H "X-API-Key: YOUR_API_KEY"

Response Parameters

Parameter	Type	Description
messages	array	Message list (max 20 items per request)
nextCursor	string	Next page cursor for getting more data
total	number	Total number of messages

Message Objects in messages Array

Parameter	Type	Description
id	string	Unique identifier of the message (UUID format)
from_address	string	Sender address
subject	string	Message subject
received_at	number	Received time (Unix timestamp in milliseconds)

Response Example

{
  "messages": [
    {
      "id": "fd13a8df-1465-4fbc-a612-ca7311c31ff2",
      "from_address": "sender1@example.com",
      "subject": "Test Message 1 - xJOK2h",
      "received_at": 1745224245084
    }
  ],
  "nextCursor": "eyJ0aW1lc3RhbXAiOjE3NDUxNTU4NDUwODQsImlkIjoiNjNmNzFlODYtOGE1NC00ZDQ0LTk5ZWYtN2QzNTBhMTQ4M2JiIn0=",
  "total": 50
}

Get Message Details

Get detailed content of the specified message.

Request

GET /api/emails/{emailId}/{messageId}

Request Parameters

Parameter	Type	Required	Description
emailId	string	Yes	Email ID (path parameter)
messageId	string	Yes	Message ID (path parameter)

Request Example

curl "https://chat-tempmail.com/api/emails/99fadf12-6826-490a-9c6c-b0b528d4a8e0/fd13a8df-1465-4fbc-a612-ca7311c31ff2" \
  -H "X-API-Key: YOUR_API_KEY"

Response Parameters

Parameter	Type	Description
message	object	Message details

message Object Fields

Parameter	Type	Description
id	string	Unique identifier of the message (UUID format)
from_address	string	Sender address
subject	string	Message subject
content	string	Message plain text content
html	string	Message HTML content (may be empty)
received_at	number	Received time (Unix timestamp in milliseconds)

Response Example

{
  "message": {
    "id": "fd13a8df-1465-4fbc-a612-ca7311c31ff2",
    "from_address": "sender1@example.com",
    "subject": "Test Message 1 - xJOK2h",
    "content": "Test Message 1\n\nThis is test message 1 content.\n\nBest regards,\nSender 1",
    "html": "<div>\n<h1>Test Message 1</h1>\n </div>",
    "received_at": 1745224245084
  }
}

Delete Message

Delete the specified message.

Request

DELETE /api/emails/{emailId}/{messageId}

Request Parameters

Parameter	Type	Required	Description
emailId	string	Yes	Email ID (path parameter)
messageId	string	Yes	Message ID (path parameter)

Request Example

curl -X DELETE "https://chat-tempmail.com/api/emails/76d91ae5-822a-4fdd-8701-9de038ec86d7/20e77445-b0c3-4e8b-aa29-762ea423ac15" \
  -H "X-API-Key: YOUR_API_KEY"

Response Parameters

Parameter	Type	Description
success	boolean	Whether deletion was successful

Response Example

{
  "success": true
}

API Documentation

Authentication

Get API Key

Using API Key

Important Notes