# See mail left alone, and why

Source: https://docs.vlayers.ai/reference/email/list-skipped-mail

`GET /v1/email/skipped-mail` · scope `mailbox:use`

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.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `mailbox` | query | string | no | Only this inbox, by address. Example: `"support@acme.vlayersmail.com"` |
| `limit` | query | integer | no | How many items to return, 1–200. Default 50. Example: `20` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/email/skipped-mail?limit=20" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { summary } = await voicelayer.email.listSkippedMail({ limit: 20 });
console.log(summary);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.email.list_skipped_mail(limit=20)
print(result.summary)
```

## Response `200`

```json
{
  "skipped": [
    {
      "id": "0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32",
      "mailbox": "support@acme.vlayersmail.com",
      "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."
}
```
