> ## Documentation Index
> Fetch the complete documentation index at: https://api.smartlead.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Run Emails

> Per-email results of a run, with authentication and bounce details

> [!NOTE]
>
> **Smart Delivery v2 (Deliverability Test) API**: the deliverability (inbox placement) test that sends your campaign email to seed inboxes and reports where it landed. Contact [support@smartlead.ai](mailto:support@smartlead.ai) for access.

## Overview

One item per test email, in ID order. Filter by provider, sender or placement and page with `nextCursor`.

## Path Parameters

**id** `string` *required*

Run ID (UUID)

## Query Parameters

**api\_key** `string` *required*

Your SmartLead API key

**provider** `string`

Provider code, for example `GOOGLE_WORKSPACE`

**senderId** `number`

Smartlead email account ID of the sender

**placement** `string`

`INBOX`, `TAB`, `SPAM`, `MISSING`, `UNREADABLE`, `NOT_SENT`, `UNCONFIRMED`, `PENDING` or `BOUNCED`

**limit** `number`

Page size, 1 to 200. Default 50

**cursor** `string`

`nextCursor` from the previous page

```bash cURL theme={null}
curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/emails?api_key=YOUR_KEY"
```

```python Python theme={null}
import requests

API_KEY = "YOUR_API_KEY"

response = requests.get(
    "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/emails",
    params={"api_key": API_KEY}
)
print(response.status_code)
print(response.json())
```

```javascript JavaScript theme={null}
const API_KEY = 'YOUR_API_KEY';

const response = await fetch(
  `https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/emails?api_key=${API_KEY}`,
  {
    method: 'GET'
  }
);
console.log(await response.json());
```

## Response Fields

**items** `array`

**email**

**assignmentId** `number`

Email ID

**provider** `string`

Provider code

**senderEmailAccountId** `number`

Smartlead email account ID of the sender

**senderEmail** `string`

Sending mailbox

**placement** `string`

Placement

**sentAt** `string | null`

Sent time

**tab** `string | null`

Inbox tab it landed in, where the provider has tabs

**receivedAt** `string | null`

When the copy was received

**timeToInboxMs** `number | null`

Send-to-inbox time

**auth** `object`

`spf`, `dkim`, `dmarc`, `arc`, `compauth` and `dmarcAligned` results of the received copy

**senderIp** `string | null`

IP the email was sent from

**senderPtr** `string | null`

Reverse DNS name of that IP

**fcrdnsOk** `boolean | null`

Whether the reverse DNS name resolves back to the IP

**sizeBytes** `number | null`

Message size

**hasListUnsubscribe** `boolean | null`

Whether a List-Unsubscribe header is present

**microsoft** `object | null`

Microsoft filter verdict (`scl`, `bcl`, `verdict`, `category`). `null` for copies not received at Microsoft

**captured** `boolean`

Whether a copy of the received email is stored

**bounce** `object | null`

`cause`, `status` and `reason` when the email bounced

**nextCursor** `string | null`

Pass as `cursor` for the next page. `null` on the last page

## Response Codes

**200** `Success`

Success

**404** `Error`

Run not found (`RUN_NOT_FOUND`)

**401** `Unauthorized`

Missing, invalid or expired API key (`UNAUTHORIZED`)

**403** `Forbidden`

Client (agency) API keys are not allowed (`CLIENT_NOT_ALLOWED`), or your plan does not include API access (`API_ACCESS_RESTRICTED`)

**429** `Too Many Requests`

Too many requests for this API key. Wait the number of seconds in the `Retry-After` header (`RATE_LIMITED`)

```json 200 - Success theme={null}
{
  "items": [
    {
      "assignmentId": 90211,
      "provider": "GOOGLE_WORKSPACE",
      "senderEmailAccountId": 88101,
      "senderEmail": "alex@sender-one.com",
      "placement": "INBOX",
      "sentAt": "2026-11-17T08:31:14.000Z",
      "tab": "PRIMARY",
      "receivedAt": "2026-11-17T08:31:50.000Z",
      "timeToInboxMs": 36000,
      "auth": { "spf": "pass", "dkim": "pass", "dmarc": "pass", "arc": null, "compauth": null, "dmarcAligned": true },
      "senderIp": "203.0.113.24",
      "senderPtr": "mail.sender-one.com",
      "fcrdnsOk": true,
      "sizeBytes": 18340,
      "hasListUnsubscribe": true,
      "microsoft": null,
      "captured": true,
      "bounce": null
    }
  ],
  "nextCursor": null
}
```

```json Error - Unauthorized theme={null}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API Key"
  }
}
```

## Related Endpoints

* [Get Run](https://api.smartlead.ai/api-reference/smart-delivery-v2/get-run.md)
* [Get Email Headers](https://api.smartlead.ai/api-reference/smart-delivery-v2/email-headers.md)
* [List Run Seeds](https://api.smartlead.ai/api-reference/smart-delivery-v2/run-seeds.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.