Intelligent Email API Solution

API Documentation

Authentication

All API requests must include your personal API key in the HTTP headers. You will receive your key after purchasing a plan.

APIKey: YOUR_SECRET_API_KEY

Endpoint: Read Emails

To fetch emails, send a GET request to the following endpoint. You can optionally filter emails for a specific recipient using the `to` query parameter.

GET https://api.imail.edu.vn/emails?to=user@imail.edu.vn

Example Request (cURL)

Here is an example of how to make a request using cURL from your terminal.

curl -X GET -H "APIKey: YOUR_SECRET_API_KEY" "https://api.imail.edu.vn/emails?to=user@imail.edu.vn"

Success Response (200 OK)

A successful request will return a JSON object containing an array of emails.

[
  {
    "emails": [
      {
        "from": "sender@company.com",
        "to": "User Name <user@example.com>",
        "subject": "Your Email Subject",
        "date": "2025-06-28 10:30:00",
        "body": "This is the plain text content of the email..."
      }
    ]
  }
]

Error Response (401 Unauthorized)

If your API key is missing or invalid, you will receive an error response like this.

{
  "status": "error",
  "message": "Unauthorized: Invalid or missing API Key."
}