> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [/docs/api/domains/openapi.json](/docs/api/domains/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Domains: List the health of many domains

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

One endpoint of [Domains](/docs/api/domains.md). Authentication, workspaces and errors: [/docs.md](/docs.md).

## List the health of many domains

`GET /v1/domains/health` - operationId `domains.list-health`

| Permission | Rate limit |
| --- | --- |
| Delivery view | 12,000 requests a minute per API key |

Returns the latest health results for up to 200 domains in one call, such as every domain on a page. Each item
is what `GET /v1/domains/{domainId}/health` returns for that domain, so the fields, their sources and how
fresh they are read the same way there.

`domainIds` is required: 1 to 200 domain ids, comma-separated, such as `domainIds=4,9,12`. Items come
in the order of `domainIds`, and Kenso ignores a repeated id. An id that is not a domain of this workspace
has no item, where the one-domain read answers `404`. The list has no further pages:
`pagination.hasMore` is always false.

Errors:

- `400 validation_failed`: `domainIds` is missing, has a value that is not a positive whole number, or
has more than 200 ids.

Requires Delivery view.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/domains/GET/v1/domains/health)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `domainIds` | query | string | no | The domains to read: 1 to 200 domain ids, comma-separated. |
| `Ken-Version` | header | string, one of: 2026-11-02, 1.1 | no | The API version, a date in `YYYY-MM-DD` form. `1.1` is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and `404` where the path exists only in this version. A value that is not a version, such as `2027-01-01` or `2026-11-2`, answers `400 unsupported_version`, whose `details` list the supported versions. |
| `X-Ken-Workspace-Id` | header | integer (int64) | no | The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers `400 workspace_required`. A workspace you are not a member of answers `404 not_found`. |

### Response 200

`data` is a list of `DomainHealth`. Each item has these fields. The response also carries `pagination`.

| Field | Type | Description |
| --- | --- | --- |
| `domainId` | integer (int64) | The domain's id. |
| `name` | string | The domain name, such as `acme-mail.com`. |
| `blacklistStatus` | string | Blocklist result of the latest check: `clean`, `listed`, `delisted` or `pending_delisting`. Omitted before the first check. |
| `listedCount` | integer (int32) | How many blocklists the domain was on at the latest check. 0 before the first check. |
| `listedZones` | array of string | Names of the blocklists the domain was on at the latest check. Empty when it was on none. |
| `checkedAt` | string (date-time) | When the latest health check ran, in UTC. Omitted before the first check. |
| `spfStatus` | string | SPF result of the latest check: `pass`, `fail` or `unknown`. Omitted before the first check. |
| `dkimStatus` | string | DKIM result of the latest check: `pass`, `fail` or `unknown`. Omitted before the first check. |
| `dmarcStatus` | string | DMARC result of the latest check: `pass`, `fail` or `unknown`. Omitted before the first check. |
| `mxStatus` | string | MX result of the latest check: `pass`, `fail` or `unknown`. Omitted before the first check. |
| `hasSpf` | boolean | True when `spfStatus` is `pass`. |
| `hasDkim` | boolean | True when `dkimStatus` is `pass`. |
| `hasDmarc` | boolean | True when `dmarcStatus` is `pass`. |
| `hasMx` | boolean | True when `mxStatus` is `pass`. |
| `isChecked` | boolean | True when the latest check got a clear `pass` or `fail` for SPF, DKIM and DMARC. False before the first check and while any of the three is `unknown`. |
| `dkimSelector` | string | The DKIM selector the latest check read, such as `google`. Omitted when the check found none. |
| `bounceRate` | number (double) | Share of the domain's emails that bounced in the latest bounce reading, as a fraction from 0 to 1. Omitted before the first reading. |
| `bounceStatus` | string | The verdict of the latest bounce reading, as the mailbox host reports it. Omitted before the first reading. |
| `bounceCheckedAt` | string (date-time) | When Kenso last read the domain's bounces, in UTC. Omitted before the first reading. |
| `bounceEmailCount` | integer (int32) | How many emails the latest bounce reading counted. Omitted before the first reading. |
| `bouncedEmailCount` | integer (int32) | How many of those emails bounced. Omitted before the first reading. |
| `inboxRate` | number (double) | Share of test emails that reached the inbox in the domain's latest completed placement test, as a fraction from 0 to 1. Omitted when the domain has no completed test. |
| `spamRate` | number (double) | Share of test emails that landed in spam in that placement test, as a fraction from 0 to 1. Omitted when the domain has no completed test. |
| `placementStatus` | string | Status of that placement test. Omitted when the domain has no completed test. |
| `placementCompletedAt` | string (date-time) | When that placement test finished, in UTC. Omitted when the domain has no completed test. |
| `infraguardStatus` | string | Status of the domain's monitoring subscription with its mailbox host, such as `active`. Omitted when the domain has none. |
| `nameserverStatus` | string | Result of the latest nameserver check: `verified` (the nameservers are the expected ones), `not_moved` (the registrar's default nameservers are still in place), `moved_wrong_provider` (the domain points at nameservers other than the expected ones), `failed` (no nameservers found) or `lookup_failed` (the lookup did not finish). Omitted before a check. |
| `nameservers` | array of string | The nameservers Kenso found for the domain. Empty when none are known. |
| `sslStatus` | string | State of the domain's SSL certificate at the latest check: `valid`, `expiring_soon`, `expired`, `invalid` or `unreachable`. Omitted when the check did not read it. |
| `sslExpiresAt` | string (date-time) | When the domain's SSL certificate expires, in UTC. Omitted when unknown. |
| `ipAbuseScore` | integer (int32) | Abuse score of the domain's sending IP from the latest check. Omitted when the check has none. |
| `blocklistVerdict` | string | Whether the domain is on a blocklist, as Kenso decides it: `listed`, `clean` or `unknown`. It combines Kenso's own daily blocklist check of the domain with the latest health check, by the rule Kenso's deliverability alerts use to call a domain blocklisted. `listed` when the daily check lists the domain, or when the latest health check is no more than 7 days old and says listed, unless the only zones it names are URIBL grey (every other zone counts, URIBL black and red included). `clean` when neither lists it and the daily check, or a health check no more than 7 days old, answered clean. `unknown` when neither has a current answer: no daily check result, and the latest health check is missing, more than 7 days old or has no recognised status. A health check that names only URIBL grey is `clean` here even when `blacklistStatus` says `listed`, because Kenso does not count grey as a listing. Prefer this to `blacklistStatus` to tell whether the domain is listed. |
| `listedSince` | string (date-time) | When Kenso first saw the domain listed, in UTC: the earliest of the day Kenso's daily blocklist check first saw the listing (kept across gaps in that check) and the listing health check. Set only when `blocklistVerdict` is `listed`; omitted otherwise. |
| `uriblGreyOnly` | boolean | True when the latest health check, whatever its age, says listed and names only URIBL grey (a list of bulk senders that Kenso does not count as a listing, so no action is needed). Like `blacklistStatus`, it describes that check; `blocklistVerdict` says whether it still counts. `blacklistStatus` and `listedZones` still show the check as the health check recorded it. |

### Request

```bash
curl -X GET "https://api.ken.so/v1/domains/health" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"
```

### Example response

```json
{
  "success": true,
  "data": [
    {
      "domainId": 812,
      "name": "acme-mail.com",
      "blacklistStatus": "clean",
      "listedCount": 1,
      "listedZones": [
        "string"
      ],
      "checkedAt": "2026-09-23T15:02:11Z",
      "spfStatus": "pass",
      "dkimStatus": "pass",
      "dmarcStatus": "pass",
      "mxStatus": "pass",
      "hasSpf": true,
      "hasDkim": true,
      "hasDmarc": true,
      "hasMx": true,
      "isChecked": true,
      "dkimSelector": "google",
      "bounceRate": 0.5,
      "bounceStatus": "string",
      "bounceCheckedAt": "2026-09-23T15:02:11Z",
      "bounceEmailCount": 1,
      "bouncedEmailCount": 1,
      "inboxRate": 0.5,
      "spamRate": 0.5,
      "placementStatus": "string",
      "placementCompletedAt": "2026-09-23T15:02:11Z",
      "infraguardStatus": "active",
      "nameserverStatus": "string",
      "nameservers": [
        "string"
      ],
      "sslStatus": "valid",
      "sslExpiresAt": "2026-09-23T15:02:11Z",
      "ipAbuseScore": 1,
      "blocklistVerdict": "listed",
      "listedSince": "2026-09-23T15:02:11Z",
      "uriblGreyOnly": true
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6ODE1fQ",
    "hasMore": true,
    "total": 1,
    "totalCount": 1,
    "isTotalCapped": true
  }
}
```
