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

> Live placement summary of a run, by provider and sender

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

A light call to poll while a run is sending or collecting. For the full scored report use [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/placement?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/placement",
    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/placement?api_key=${API_KEY}`,
  {
    method: 'GET'
  }
);
console.log(await response.json());
```

## Response Fields

**runId** `string`

Run ID

**status** `string`

Run status

**held** `boolean`

`true` when the test is paused and unsent emails are waiting

**collectingUntil** `string | null`

End of the window in which results are collected

**resultsExpectedAt** `string | null`

When the final results are expected

**nextSendAt** `string | null`

Planned time of the next email still to go out

**lastSendAt** `string | null`

Planned time of the last email

**sent** `number`

Emails sent so far

**unsent** `number`

Emails still to be sent

**totals** `object`

Placement counts for the whole run: `inbox`, `tab`, `spam`, `missing`, `unreadable`, `unconfirmed`, `notSent`, `pending`, `bounced`, `total`, `measured` and `percent` (`inbox`, `tab`, `spam`, `missing` as a share of `measured`, or `null`)

**byProvider** `array`

Same counts per `provider`

**bySender** `array`

Same counts per `senderEmail`

**byProviderAndSender** `array`

Same counts per `provider` and `senderEmail`

## 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}
{
  "runId": "8a1c7e90-2b3d-4c5e-8f60-7a9b0c1d2e3f",
  "status": "COLLECTING",
  "held": false,
  "collectingUntil": "2026-11-17T09:20:00.000Z",
  "resultsExpectedAt": "2026-11-17T09:20:00.000Z",
  "nextSendAt": null,
  "lastSendAt": "2026-11-17T08:50:00.000Z",
  "sent": 8,
  "unsent": 0,
  "totals": { "inbox": 6, "tab": 1, "spam": 1, "missing": 0, "unreadable": 0, "unconfirmed": 0, "notSent": 0, "pending": 0, "bounced": 0, "total": 8, "measured": 8,
    "percent": { "inbox": 75, "tab": 12.5, "spam": 12.5, "missing": 0 } },
  "byProvider": [ { "provider": "GOOGLE_WORKSPACE", "inbox": 3, "total": 4 } ],
  "bySender": [ { "senderEmail": "alex@sender-one.com", "inbox": 6, "total": 8 } ],
  "byProviderAndSender": [ { "provider": "GOOGLE_WORKSPACE", "senderEmail": "alex@sender-one.com", "inbox": 3, "total": 4 } ]
}
(per-group counts abbreviated)
```

```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 Run Report](https://api.smartlead.ai/api-reference/smart-delivery-v2/run-report.md)


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