> ## 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 Deliverability Test

> Get one deliverability test with its senders, providers and runs

> [!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 test, its provider codes and sender mailboxes, and its latest 50 runs. A run in flight carries a `progress` block.

## Path Parameters

**id** `string` *required*

Test 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/tests/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/tests/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/tests/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b?api_key=${API_KEY}`,
  {
    method: 'GET'
  }
);
console.log(await response.json());
```

## Response Fields

**id** `string`

Test ID (UUID). Use it in every `/tests/{id}` path.

**name** `string`

Test name

**description** `string | null`

Test description

**type** `string`

`MANUAL` (one run, started now) or `AUTO` (recurring runs on a schedule)

**status** `string`

`ACTIVE`, `PAUSED`, `COMPLETED` or `STOPPED`

**statusReason** `string | null`

Why the test is in this status, for example `USER_PAUSED`, `USER_STOPPED` or `SCHEDULE_ENDED`

**folderId** `number | null`

Folder the test is in

**campaignId** `number`

Smartlead campaign whose email is tested

**sequenceId** `number`

Sequence step that is tested

**variantId** `number | null`

A/B variant tested, or `null` for the step's base email

**seedsPerSenderPerProvider** `number`

Seed inboxes each sender mails per provider

**sendAllAtOnce** `boolean`

`true` when all emails of a run go out together, `false` when they are spread by `sendGapMinutes`

**sendGapMinutes** `number | null`

Minutes between emails when they are spread out

**textOnly** `boolean`

Whether the emails are sent as text only (no HTML)

**schedule** `object | null`

`AUTO` tests: the schedule (see Create Deliverability Test)

**startsAt** `string | null`

`AUTO` tests: first run time (ISO 8601)

**endsAt** `string | null`

`AUTO` tests: the date after which no run starts

**maxRuns** `number | null`

`AUTO` tests: the number of runs after which the test completes

**nextRunAt** `string | null`

`AUTO` tests: when the next run starts

**runsCreated** `number`

Runs created so far

**createdAt** `string`

Creation time (ISO 8601)

**providers** `string[]`

Provider codes the test sends to

**senders** `array`

**sender**

**id** `number`

Sender row ID

**emailAccountId** `number`

Smartlead email account ID

**email** `string`

Sender address

**senderType** `string`

Mailbox type

**runs** `array`

The test's runs, newest first (up to 50). Same fields as [Get Run](https://api.smartlead.ai/api-reference/smart-delivery-v2/get-run.md) without the emails, plus `progress` (`sent`, `unsent`, `total`, `held`, `resultsExpectedAt`) while the run is in flight, otherwise `null`.

## Response Codes

**200** `Success`

Success

**404** `Error`

Test not found (`TEST_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": "3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b",
  "name": "Q4 Outbound - sequence step 1",
  "type": "MANUAL",
  "status": "ACTIVE",
  "providers": ["GOOGLE_WORKSPACE", "MICROSOFT_365"],
  "senders": [
    { "id": 501, "emailAccountId": 88101, "email": "alex@sender-one.com", "senderType": "SMTP" }
  ],
  "runs": [
    {
      "id": "8a1c7e90-2b3d-4c5e-8f60-7a9b0c1d2e3f",
      "runNo": 1,
      "status": "SENDING",
      "progress": { "sent": 9, "unsent": 15, "total": 24, "held": false, "resultsExpectedAt": "2026-11-17T09:20:00.000Z" }
    }
  ]
}
(other test and run fields omitted)
```

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

## Related Endpoints

* [List Deliverability Tests](https://api.smartlead.ai/api-reference/smart-delivery-v2/list-tests.md)
* [Update Deliverability Test](https://api.smartlead.ai/api-reference/smart-delivery-v2/update-test.md)
* [Get Run](https://api.smartlead.ai/api-reference/smart-delivery-v2/get-run.md)


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