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

# Auto-pauses: List auto-pauses

> **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 [Auto-pauses](/docs/api/auto-pauses.md). Authentication, workspaces and errors: [/docs.md](/docs.md).

## List auto-pauses

`GET /v1/auto-pauses` - operationId `auto-pauses.list`

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

Lists the pauses Kenso applied on its own, newest first. Use it to find out why an inbox, domain or campaign
stopped sending.

Kenso pauses a target when a bounce, complaint, Gmail spam or sender rejection rate crosses its threshold, a
placement test lands in spam, a domain is on a URI blocklist, Kenso cannot read an inbox's replies, or
Microsoft blocks the sending tenant. Pauses you set yourself are not listed.

Repeated hard send failures do not pause a campaign: it keeps sending, its `sendingError` describes the
failures, and the Kenso team gets an alert.

The list holds every pause that started at or after `since`, plus any older pause that is still active.
A block that Kenso renewed before it lifted counts as one pause. `isActive` is true while the target is
still paused. Page with `limit` and `cursor`.

Errors:

- `400 validation_failed`: `limit` is not from 1 to 200, or `cursor` is invalid.

Requires Campaigns view.

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

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `since` | query | string (date-time) | no | Earliest pause start to list, an ISO 8601 timestamp that is not in the future. Default 7 days ago, and Kenso reads a time more than 30 days ago as 30 days ago. |
| `limit` | query | integer (int32) | no | Number of pauses per page, from 1 to 200. Default 50. |
| `cursor` | query | string | no | The `nextCursor` from the previous page. Omit it for the first page. |
| `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 `AutoPause`. Each item has these fields. The response also carries `pagination`.

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | Id of the pause. It stays the same for the life of one pause. |
| `scope` | string | What Kenso paused: `inbox`, `domain`, `campaign` or `workspace`. A domain pause blocks the domain's inboxes, not its campaigns. A workspace pause (reason `workspace_breaker`) blocks every inbox in the workspace until Kenso support releases it. |
| `reason` | string | Why Kenso paused it: `mailbox_hard_bounce_rate`, `campaign_hard_bounce_rate`, `domain_complaint_rate`, `domain_gmail_spam_rate`, `domain_placement_spam`, `reply_ingest_dead`, `uri_blocklist_listed`, `domain_dns_unresolvable`, `tenant_ban` (Microsoft blocked the sending tenant), `mailbox_sender_ndr_rate`, `workspace_breaker` or `send_failures`. Kenso may add new codes, so handle unknown values. |
| `metric` | string | The measure that tripped the pause: `bounce_rate`, `complaint_rate`, `gmail_spam_rate`, `sender_ndr_rate` (the share of sends the inbox's own provider refused) or `dns`. `other` appears only for a reason added later. Omitted when no rate drives the reason. |
| `rate` | number (double) | The rate that tripped the pause, as a fraction from 0 to 1. Omitted when the reason has no rate. |
| `threshold` | number (double) | The threshold the rate crossed, as a fraction from 0 to 1. Omitted when the reason has no rate. |
| `domainId` | integer (int64) | Id of the paused domain, or of the domain the paused inbox sends from. Omitted for a campaign or workspace pause. |
| `domainName` | string | Name of the domain in `domainId`, such as `example.com`. |
| `inboxId` | integer (int64) | Id of the paused inbox. Omitted unless `scope` is `inbox`. |
| `inboxEmail` | string | Email address of the inbox in `inboxId`. |
| `inboxCount` | integer (int32) | Number of inboxes the pause blocked. Omitted for a campaign. |
| `campaignId` | integer (int64) | Id of the paused campaign. Omitted unless `scope` is `campaign`. |
| `campaignName` | string | Name of the campaign in `campaignId`. |
| `createdAt` | string (date-time) | When the pause started, in UTC. A block that Kenso renewed before it lifted keeps its first start time. |
| `blockedUntil` | string (date-time) | When an inbox, domain or workspace block ends or ended, in UTC. Omitted for a campaign, which stays paused until someone resumes it. Kenso renews a workspace pause until support releases it, so while it is active this is only the current expiry. |
| `isActive` | boolean | True while the target is still paused. |

### Request

```bash
curl -X GET "https://api.ken.so/v1/auto-pauses?limit=50" \
  -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": [
    {
      "id": "string",
      "scope": "inbox",
      "reason": "string",
      "metric": "string",
      "rate": 0.5,
      "threshold": 0.5,
      "domainId": 812,
      "domainName": "example.com",
      "inboxId": 812,
      "inboxEmail": "jane@example.com",
      "inboxCount": 1,
      "campaignId": 812,
      "campaignName": "string",
      "createdAt": "2026-09-23T15:02:11Z",
      "blockedUntil": "2026-09-23T15:02:11Z",
      "isActive": true
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6ODE1fQ",
    "hasMore": true,
    "total": 1,
    "totalCount": 1,
    "isTotalCapped": true
  }
}
```
