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

> The stored deliverability report of a completed run

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

Returns the score, placement counts, breakdowns and diagnostics (blocklists, DNS, content, SpamAssassin, sender mailboxes) of a completed run. Until the report is built the response is `{ "ready": false, "status": "..." }`: poll [Get Run Placement](https://api.smartlead.ai/api-reference/smart-delivery-v2/run-placement.md) or this endpoint until `ready` is `true`.

## 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/report?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/report",
    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/report?api_key=${API_KEY}`,
  {
    method: 'GET'
  }
);
console.log(await response.json());
```

## Response Fields

**ready** `boolean`

`false` while the report is not built yet. Then only `status` follows

**runId** `string`

Run ID

**completedAt** `string`

When the run completed

**score** `number | null`

Deliverability score, 0 to 100

**band** `string | null`

`poor` (below 40), `fair` (40 to 79) or `good` (80 and above)

**parts** `array`

The score's parts (`placement`, `auth`, `content`, `reputation`, `hygiene`) with `weight` and `value` (0 to 1, `null` when not available for this run)

**counts** `object`

Counts for the emails sent: `expected`, `sent`, `failed`, `inbox`, `tab`, `spam`, `missing`, `unreadable`, `notSent`, `unconfirmed`, `bouncedSeed`, `bouncedSender`, `bouncedUnknown`, `spfFail`, `dkimFail`, `dmarcFail`, and `inboxRate` (inbox share of the emails that reached a verdict, 0 to 1, or `null` when none did). Seed-side bounces (`bouncedSeed`) are left out of the placement rate; sender-side and unknown bounces count as not delivered.

**timeToInbox** `object`

`medianMs` and `p90Ms`: time from send to inbox

**headline** `object | null`

One-line summary of the result

**baseline** `object | null`

How the score compares with other Smart Delivery tests

**insights** `object | null`

The issues found and how to fix them, and the checks that passed

**captureIncomplete** `boolean`

`true` when a copy of some received emails could not be stored, so some details are missing

**seedFallback** `boolean`

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

**byProvider** `array`

`provider` and `counts` per provider

**bySender** `array`

`emailAccountId`, `senderEmail`, `sendingDomain` and `counts` per sender

**matrix** `array`

`provider`, `emailAccountId` and `counts` for every provider and sender pair

**diagnostics** `object`

`blacklists`, `dns`, `content`, `spamAssassin` and `senders` checks

## 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}
{
  "ready": true,
  "runId": "8a1c7e90-2b3d-4c5e-8f60-7a9b0c1d2e3f",
  "completedAt": "2026-11-17T09:21:00.000Z",
  "score": 72,
  "band": "fair",
  "counts": {
    "expected": 24, "sent": 24, "failed": 0,
    "inbox": 18, "tab": 2, "spam": 3, "missing": 1,
    "unreadable": 0, "notSent": 0, "unconfirmed": 0,
    "bouncedSeed": 0, "bouncedSender": 0, "bouncedUnknown": 0,
    "spfFail": 0, "dkimFail": 0, "dmarcFail": 0,
    "inboxRate": 0.75
  },
  "timeToInbox": { "medianMs": 41000, "p90Ms": 118000 },
  "byProvider": [ { "provider": "GOOGLE_WORKSPACE", "counts": { "inbox": 9, "spam": 1, "inboxRate": 0.9 } } ],
  "diagnostics": { "blacklists": [], "dns": [], "content": null, "spamAssassin": null, "senders": [] }
}
(shortened: parts, headline, baseline, insights, bySender and matrix omitted)
```

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

## Related Endpoints

* [List Run Emails](https://api.smartlead.ai/api-reference/smart-delivery-v2/run-emails.md)
* [List Run Seeds](https://api.smartlead.ai/api-reference/smart-delivery-v2/run-seeds.md)
* [Compare Two Runs](https://api.smartlead.ai/api-reference/smart-delivery-v2/compare-runs.md)
* [Get Test History](https://api.smartlead.ai/api-reference/smart-delivery-v2/test-history.md)


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