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

# People and company search: Get an import

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

## Get an import

`GET /v1/search/imports/{importId}` - operationId `search.get-import`

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

Get the progress of one import into a campaign. Poll it after `POST /v1/search/imports` until the import
ends.

`status` is `Queued` or `Processing` while the import runs, then a final value such as
`Ready` or `Failed`. The answer also holds the counts (`totalRecords`, `processedRecords`
and `importedCount`), the people skipped by reason under `skips`, and `errorMessage` when the
import failed.

Errors:

- `401 unauthenticated`: the API key belongs to no member.
- `404 not_found`: no import has this id in this workspace.

Requires Campaigns view.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/search/GET/v1/search/imports/%7BimportId%7D)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `importId` | path | integer (int64) | yes | The import's id, the `jobId` that `POST /v1/search/imports` returned. |
| `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 `SearchImport`.

| Field | Type | Description |
| --- | --- | --- |
| `jobId` | integer (int64) | The import's id. |
| `status` | string | `Queued` or `Processing` while the import runs, then `Ready`, `CompletedWithErrors`, `Failed` or `Expired`. |
| `totalRecords` | integer (int32) | The number of people the import aims to add. |
| `processedRecords` | integer (int32) | The number of people the campaign has accepted so far, before the final duplicate check. |
| `downloadUrl` | string | A campaign import has no file to download, so this is always null. |
| `errorMessage` | string | Why the import failed, when it did. Null otherwise. |
| `campaignImport` | SearchImportProgress | How the import is filling the campaign, batch by batch. Null before its first progress update. |
| `createdAt` | string | When the import was created, in UTC. ISO 8601, such as `2026-11-15T10:00:00`, with or without a trailing `Z`. |
| `completedAt` | string | When the import ended, in UTC. ISO 8601, such as `2026-11-15T10:00:00`, with or without a trailing `Z`. Null while it runs. |
| `phase` | string | The step the import is on: `Queued`, `Importing`, `Enriching` or `Deduping`. Null once it ends. |
| `importRunId` | integer (int64) | The id of the Kenso import run that records this import's contacts, once known. Null before. |
| `importedCount` | integer (int32) | The contacts this import added to the campaign after removing duplicates. Null until known. |
| `targetCount` | integer (int32) | The number of people you asked the import to take (the import's `limit`). Null until known. |
| `attemptedCount` | integer (int32) | The number of people the import tried to add. Null until known. |
| `unfilledCount` | integer (int32) | How many people short of `targetCount` the import ended, because the search had no more matches. Null until known. |
| `skips` | SearchImportSkips | The people the import skipped, counted by reason. Null until known. |
| `recentlyContactedWindowDays` | integer (int32) | The window, in days, in which a person counts as already contacted. Null when the import does not skip people for recent contact. |

### Request

```bash
curl -X GET "https://api.ken.so/v1/search/imports/812" \
  -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": {
    "jobId": 812,
    "status": "Queued",
    "totalRecords": 1,
    "processedRecords": 1,
    "downloadUrl": "https://example.com",
    "errorMessage": "string",
    "campaignImport": {
      "requestedTarget": 1,
      "totalImported": 1,
      "totalSkippedDuplicate": 1,
      "totalSkippedAlreadyInCampaign": 1,
      "totalCandidatesAttempted": 1,
      "exhausted": true,
      "stopReason": "target-reached",
      "roundsCompleted": 1,
      "batches": [
        {
          "round": 1,
          "batchNumber": 1,
          "candidateCount": 1,
          "imported": 1,
          "skippedDuplicate": 1,
          "success": true,
          "attempts": 1,
          "errorMessage": "string"
        }
      ],
      "storeBusyRetries": 1,
      "phase": "Queued",
      "importRunId": 812,
      "importedCount": 1,
      "targetCount": 1,
      "attemptedCount": 1,
      "unfilledCount": 1,
      "skips": {
        "failedValidation": 1,
        "alreadyContacted": 1,
        "duplicateInCampaign": 1,
        "duplicateInSource": 1,
        "duplicateInOtherCampaign": 1,
        "blocklist": 1,
        "other": 1
      },
      "recentlyContactedWindowDays": 1
    },
    "createdAt": "2026-11-15T10:00:00",
    "completedAt": "2026-11-15T10:00:00",
    "phase": "Queued",
    "importRunId": 812,
    "importedCount": 1,
    "targetCount": 1,
    "attemptedCount": 1,
    "unfilledCount": 1,
    "skips": {
      "failedValidation": 1,
      "alreadyContacted": 1,
      "duplicateInCampaign": 1,
      "duplicateInSource": 1,
      "duplicateInOtherCampaign": 1,
      "blocklist": 1,
      "other": 1
    },
    "recentlyContactedWindowDays": 1
  }
}
```

## Types

Each named type the tables above use, nested ones included.

### SearchImportProgress

How a Search import is filling its campaign.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `requestedTarget` | integer (int32) | no | The number of people the import aims to add. |
| `totalImported` | integer (int32) | no | The number of people the campaign accepted so far. |
| `totalSkippedDuplicate` | integer (int32) | no | The number of people the campaign rejected as duplicates after a batch was sent. |
| `totalSkippedAlreadyInCampaign` | integer (int32) | no | The number of people passed over because they were already in the campaign. |
| `totalCandidatesAttempted` | integer (int32) | no | The number of people the import has tried so far. |
| `exhausted` | boolean | no | True when the search ran out of matches before the import reached its target. |
| `stopReason` | string | no | Why the import stopped filling: `target-reached`, `search-exhausted`, `safety-cap` or `backend-failed`. Null while it fills. |
| `roundsCompleted` | integer (int32) | no | The number of search rounds the import has finished. |
| `batches` | array of SearchImportBatch | no | Each batch of people the import sent to the campaign, in order. |
| `storeBusyRetries` | integer (int32) | no | How many times the import waited and retried because the search index was busy. Null when it never did. |
| `phase` | string | no | The step the import is on: `Queued`, `Importing`, `Enriching` or `Deduping`. Null once it ends. |
| `importRunId` | integer (int64) | no | The id of the Kenso import run that records this import's contacts, once known. Null before. |
| `importedCount` | integer (int32) | no | The contacts this import added to the campaign after removing duplicates. Null until known. |
| `targetCount` | integer (int32) | no | The number of people you asked the import to take. Null until known. |
| `attemptedCount` | integer (int32) | no | The number of people the import tried to add. Null until known. |
| `unfilledCount` | integer (int32) | no | How many people short of `targetCount` the import ended. Null until known. |
| `skips` | SearchImportSkips | no | The people the import skipped, counted by reason. Null until known. |
| `recentlyContactedWindowDays` | integer (int32) | no | The window, in days, in which a person counts as already contacted. Null when the import does not use one. |

### SearchImportSkips

The people a Search import skipped, counted by reason.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `failedValidation` | integer (int32) | no | People skipped because their data did not pass validation. |
| `alreadyContacted` | integer (int32) | no | People skipped because the workspace contacted them recently. |
| `duplicateInCampaign` | integer (int32) | no | People skipped because they are already in the campaign. |
| `duplicateInSource` | integer (int32) | no | People skipped because they appear more than once in the import. |
| `duplicateInOtherCampaign` | integer (int32) | no | People skipped because they are already in another campaign. |
| `blocklist` | integer (int32) | no | People skipped because the workspace's blocklist holds them. |
| `other` | integer (int32) | no | People skipped for any other reason. |

### SearchImportBatch

One batch of people a Search import sent to its campaign.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `round` | integer (int32) | no | The search round the batch belongs to. |
| `batchNumber` | integer (int32) | no | The batch's number, from 1. |
| `candidateCount` | integer (int32) | no | The number of people in the batch. |
| `imported` | integer (int32) | no | The number of the batch's people the campaign accepted. |
| `skippedDuplicate` | integer (int32) | no | The number of the batch's people the campaign rejected as duplicates. |
| `success` | boolean | no | True when the campaign took the batch. |
| `attempts` | integer (int32) | no | How many times the import sent the batch. |
| `errorMessage` | string | no | Why the batch failed, when it did. Null otherwise. |
