> ## 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.

# Get Run

> Get a run with the status of every email in it

> [!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

Use it to follow a run while it sends and while results come in. Once `status` is `COMPLETED` the report is ready: see [Get Run Report](https://api.smartlead.ai/api-reference/smart-delivery-v2/run-report.md).

## Path Parameters

**id** `string` *required*

Run ID (UUID)

## Query Parameters

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

Your SmartLead API key

```bash cURL theme={null}
curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b?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",
    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?api_key=${API_KEY}`,
  {
    method: 'GET'
  }
);
console.log(await response.json());
```

## Response Fields

**id** `string`

Run ID (UUID)

**runNo** `number`

Run number within the test, starting at 1

**status** `string`

`QUEUED`, `SENDING`, `COLLECTING`, `COMPLETED`, `FAILED`, `SKIPPED` or `CANCELLED`

**statusReason** `string | null`

Why a run failed, was skipped or cancelled

**scheduledFor** `string`

When the run was due to start

**contentSnapshot** `object | null`

The email content that was sent (subject, body and the lead used for merge tags)

**skippedSenders** `array | null`

Senders left out of the run, with the reason

**seedFallback** `boolean`

`true` when some emails went to a different seed than first planned

**completedAt** `string | null`

When the run completed

**createdAt** `string`

Creation time

**held** `boolean`

`true` when the test is paused and this run's unsent emails are waiting

**test** `object | null`

`id`, `name`, `type` and `status` of the test the run belongs to

**assignments** `array`

One item per email

**email**

**id** `number`

Email ID within the run (the `assignmentId` of the trace, headers and emails endpoints)

**senderEmail** `string`

Sending mailbox

**provider** `string`

Provider code of the seed inbox

**sendStatus** `string`

`PLANNED`, `SENDING`, `SENT`, `FAILED` or `SKIPPED`

**errorCode** `string | null`

Why the send failed

**placement** `string`

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

**placementDetail** `string | null`

How the placement was decided

**sendAt** `string | null`

Planned send time

**sentAt** `string | null`

When it was sent

**foundAt** `string | null`

When it was found at the provider

**minutesAfterSend** `number | null`

Minutes from send to found

## 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}
{
  "id": "8a1c7e90-2b3d-4c5e-8f60-7a9b0c1d2e3f",
  "runNo": 1,
  "status": "COLLECTING",
  "held": false,
  "test": { "id": "3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b", "name": "Q4 Outbound - sequence step 1", "type": "MANUAL", "status": "ACTIVE" },
  "assignments": [
    {
      "id": 90211,
      "senderEmail": "alex@sender-one.com",
      "provider": "GOOGLE_WORKSPACE",
      "sendStatus": "SENT",
      "errorCode": null,
      "placement": "INBOX",
      "placementDetail": null,
      "sendAt": "2026-11-17T08:31:12.000Z",
      "sentAt": "2026-11-17T08:31:14.000Z",
      "foundAt": "2026-11-17T08:31:50.000Z",
      "minutesAfterSend": 1
    }
  ]
}
(other run fields omitted)
```

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

## Related Endpoints

* [Get Run Placement](https://api.smartlead.ai/api-reference/smart-delivery-v2/run-placement.md)
* [Get Run Report](https://api.smartlead.ai/api-reference/smart-delivery-v2/run-report.md)
* [List Run Emails](https://api.smartlead.ai/api-reference/smart-delivery-v2/run-emails.md)


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