See mail left alone, and why

GET
/v1/email/skipped-mail

The messages an inbox read and left alone on purpose: out-of-office replies and other automatic mail, mailing lists, and mail that was not written to the inbox. Each shows the inbox, the sender's company, when it arrived and why, in plain words. Nothing in it was deleted, and nothing was shown to the agent as a message, so it cannot reopen a conversation or start a reply. A key limited to one mailbox sees only that mailbox.

Requires an API key with the mailbox:use scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Query Parameters

mailbox?string

Only this inbox, by address.

Length3 <= length <= 200
limit?integer

How many items to return, 1–200. Default 50.

Range1 <= value <= 200

Response Body

The mail the inbox read and left alone, newest first, each with the reason in plain words

application/json
  1. response
skipped*array<>
summary*string
Example Request
curl "https://api.vlayers.ai/v1/email/skipped-mail?limit=20" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "skipped": [    {      "id": "0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32",      "mailbox": "[email protected]",      "fromDomain": "newsletter.example.com",      "reasonText": "It came from a mailing list, so it was left alone.",      "receivedAt": "2026-10-20T15:04:05.000Z"    }  ],  "summary": "1 message was read and left alone."}