1. Message APIs
ELink Open API
  • Mail APIs
    • Get Mail List
      POST
    • Get Mail Detail
      POST
    • Sync Mail Config To Local
      POST
    • Create Mail Config
      POST
    • Update Mail Config
      POST
    • Delete Mail Config
      POST
  • Proxy APIs
    • Get Proxy List
      POST
    • Get Proxy Detail
      POST
    • Create Proxy
      POST
    • Update Proxy
      POST
    • Delete Proxy
      POST
  • Message APIs
    • Get Message Folder List
      POST
    • Get Message List
      POST
    • Get Message Detail
      POST
    • Send Message
      POST
    • Mark Read Or Unread
      POST
    • Move Message To Target Folder
      POST
    • Mark Starred Or Unstarred
      POST
  1. Message APIs

Get Message List

POST
http://localhost:18321/v1/message/list
Read the message list from the remote mail server in real time. When requesting the next page, pass the previous next_offset back as offset. keyword is mutually exclusive with subject/body/from/to. POP does not support filtering. microsoft_graph does not currently support combining text filters with flagged/seen in the same request.

Request

Body Params multipart/form-dataRequired

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://localhost:18321/v1/message/list' \
--form 'token="{{token}}"' \
--form 'mail_id="mail_demo_001"' \
--form 'folder_path="INBOX"' \
--form 'limit="20"' \
--form 'offset="eyJwYWdlX3Rva2VuIjoiMiJ9"' \
--form 'keyword="invoice"' \
--form 'subject="Verify Code"' \
--form 'body="verification"' \
--form 'from="[email protected]"' \
--form 'to="[email protected]"' \
--form 'flagged="0"' \
--form 'seen="0"'

Responses

🟢200
application/json
Success
Body

Example
{
    "code": 200,
    "msg": "ok",
    "data": {
        "list": [
            {
                "message_id": "uid:10001",
                "header_message_id": "<[email protected]>",
                "mail_id": "mail_demo_001",
                "folder_id": "user_demo_001_mail_demo_001_INBOX",
                "folder_type": "inbox",
                "subject": "Welcome to the product demo",
                "from": {
                    "name": "Demo Sender",
                    "address": "[email protected]"
                },
                "sender": null,
                "to": [
                    {
                        "name": "Demo User",
                        "address": "de***@example.com"
                    }
                ],
                "cc": [],
                "bcc": [],
                "date": "2026-04-10T09:30:00.000Z",
                "preview_text": "This is a masked preview for API documentation.",
                "is_read": -1,
                "is_flagged": -1,
                "is_important": -1,
                "has_attachment": -1,
                "message_detail_download_status": 1,
                "size": 0,
                "in_reply_to": "",
                "references": [],
                "receive_protocol_type": "imap",
                "remote_thread_id": "",
                "provider_meta": {
                    "uid": 10001,
                    "sequenceId": 1501,
                    "threadSequenceText": null,
                    "threadSequenceIsUid": null
                }
            }
        ],
        "has_more": 1,
        "next_offset": "eyJwYWdlX3Rva2VuIjoiMiJ9",
        "total_count": 1501
    }
}
Modified at 2026-04-10 06:29:30
Previous
Get Message Folder List
Next
Get Message Detail
Built with