Fetch emails

Testing

GET

/v2/onebox/top-emails

Fetch paginated list of emails from a connected email account.

Request

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.zapmail.ai/api/v2/onebox/top-emails?account=abc@example.com&folder=Sent&page=1&limit=100&includeWarmUp=true' \
--header 'x-auth-zapmail;' \
--header 'x-workspace-id;' \
--header 'x-service-provider;'

Responses

🟢200Success

application/json

Body

Example

{
    "success": true,
    "data": [
        {
            "account": "abc@example.com",
            "threadId": "AAGkADUzZWZjNTNjLTE5M2ItNDA2ZC1iY2E3LWU2ZWQ5MDdhYzVjMgEQAAQGAKackCpIlFXN9ZjQazA=",
            "messageId": "<0GGB07WVCSU2.MXZV8VTDVYK12@ds3pesf00012546>",
            "subject": "New recommendation available",
            "from": [
                {
                    "address": "MSSecurity-noreply@microsoft.com",
                    "name": "Microsoft Security"
                }
            ],
            "to": [
                {
                    "address": "abc@example.com",
                    "name": "ABC Snyder"
                }
            ],
            "isRead": false,
            "isStarred": false,
            "isWarmUp": false,
            "labels": [
                "inbox"
            ],
            "folderPath": "inbox",
            "date": "2026-01-28T01:16:34Z"
        }
    ]
}

Modified at 2026-01-31 08:16:51

List Connected Accounts

get emails from a thread