List Failed Import Items

GET

jobs

{id}

items

curl "https://api.clustr-ai.com/api/public/jobs/job_jctzmfh41nr4v8hvs87eakgs48/items?status=failed" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.clustr-ai.com/api/public/jobs/job_jctzmfh41nr4v8hvs87eakgs48/items",
    params={"status": "failed"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
for item in resp.json()["data"]["items"]:
    print(item["linkedinUrl"], item["reason"])

const resp = await fetch(
  "https://api.clustr-ai.com/api/public/jobs/job_jctzmfh41nr4v8hvs87eakgs48/items?status=failed",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } },
);
const { data } = await resp.json();

{
  "success": true,
  "data": {
    "clustrJobId": "job_jctzmfh41nr4v8hvs87eakgs48",
    "jobId": "job_abc123",
    "jobStatus": "COMPLETED",
    "status": "failed",
    "itemTypes": ["contact", "employee"],
    "total": 2,
    "limit": 100,
    "offset": 0,
    "items": [
      {
        "clustrJobItemId": "item_2ymmsvynzec1qpwz7qtt6qv6dx",
        "clustrPersonId": "per_dn4x39qnxzxjhp7f5p4npnhb8z",
        "id": "eb8abb1e-a6de-4a7f-8ba4-5e7154370978",
        "itemType": "contact",
        "linkedinUrl": "https://www.linkedin.com/in/jane-doe-123",
        "linkedinId": "jane-doe-123",
        "status": "FAILED",
        "reasonCode": "profile_not_found",
        "reason": "Profile not found or removed",
        "errorMessage": "fetch profile: apify returned no profile for https://www.linkedin.com/in/jane-doe-123",
        "retryCount": 0,
        "retryable": true,
        "createdAt": "2026-09-24T09:12:03Z",
        "completedAt": "2026-09-24T09:13:41Z"
      },
      {
        "clustrJobItemId": "item_yrcd4mbn8kbc683xerbdd284tj",
        "clustrPersonId": "per_z6yzrhwpx1rnk19d2bw8q0ex64",
        "id": "0c1f3a52-51f4-4b8e-9d5c-2f8b1e7a9d10",
        "itemType": "contact",
        "linkedinUrl": "https://www.linkedin.com/in/john-roe",
        "linkedinId": "john-roe",
        "status": "FAILED",
        "reasonCode": "temporary",
        "reason": "Temporary error, retry",
        "errorMessage": "fetch profile: profile fetch: apify status 502: Bad Gateway",
        "retryCount": 0,
        "retryable": true,
        "createdAt": "2026-09-24T09:12:03Z",
        "completedAt": "2026-09-24T09:14:02Z"
      }
    ]
  }
}

{
  "success": false,
  "error": { "message": "job not found", "code": "NOT_FOUND" }
}

An import that reports failures says how many, not who. This endpoint names them: one item per LinkedIn URL the import was given, with a plain-English reason, a stable reasonCode you can branch on, and the raw errorMessage the import recorded. When Clustr holds the person’s profile, the item also carries name, headline, jobTitle, companyName and avatarUrl. A failed item usually has none, since the profile is often what could not be fetched; use linkedinUrl to identify it. By default it lists the items that failed. That includes the ones a finished import left unprocessed, which a running import would still get to. Prospects discovered through your contacts are left out unless you ask for them with itemType.

Also available to AI assistants as the list_failed_import_items tool on the MCP server. In the app, open an import’s Details in Import history.

Reasons

`reasonCode`	`reason`	What to do
`profile_not_found`	Profile not found or removed	Check the URL; the profile may be deleted or private
`invalid_url`	LinkedIn URL is not valid	Fix the URL and import it again
`temporary`	Temporary error, retry	Retry the import’s unfinished items
`timed_out`	Took too long to process, retry	Retry
`not_saved`	Could not be saved, retry	Retry
`unfinished`	Not processed before the import ended, retry	Retry
`cancelled`	Skipped because the import was cancelled	Import it again if you still want it
`pending`	Waiting to be processed	Nothing yet: the import is still running
`unknown`	Could not be imported	Retry, or send the `errorMessage` to support

New codes may be added; treat an unfamiliar one like unknown. retryable is true for the contacts that retrying the import’s unfinished items would re-process: a contact that did not complete, of an import that is no longer running, with a valid URL. A profile that was not found will most likely fail again.

curl "https://api.clustr-ai.com/api/public/jobs/job_jctzmfh41nr4v8hvs87eakgs48/items?status=failed" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.clustr-ai.com/api/public/jobs/job_jctzmfh41nr4v8hvs87eakgs48/items",
    params={"status": "failed"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
for item in resp.json()["data"]["items"]:
    print(item["linkedinUrl"], item["reason"])

const resp = await fetch(
  "https://api.clustr-ai.com/api/public/jobs/job_jctzmfh41nr4v8hvs87eakgs48/items?status=failed",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } },
);
const { data } = await resp.json();

{
  "success": true,
  "data": {
    "clustrJobId": "job_jctzmfh41nr4v8hvs87eakgs48",
    "jobId": "job_abc123",
    "jobStatus": "COMPLETED",
    "status": "failed",
    "itemTypes": ["contact", "employee"],
    "total": 2,
    "limit": 100,
    "offset": 0,
    "items": [
      {
        "clustrJobItemId": "item_2ymmsvynzec1qpwz7qtt6qv6dx",
        "clustrPersonId": "per_dn4x39qnxzxjhp7f5p4npnhb8z",
        "id": "eb8abb1e-a6de-4a7f-8ba4-5e7154370978",
        "itemType": "contact",
        "linkedinUrl": "https://www.linkedin.com/in/jane-doe-123",
        "linkedinId": "jane-doe-123",
        "status": "FAILED",
        "reasonCode": "profile_not_found",
        "reason": "Profile not found or removed",
        "errorMessage": "fetch profile: apify returned no profile for https://www.linkedin.com/in/jane-doe-123",
        "retryCount": 0,
        "retryable": true,
        "createdAt": "2026-09-24T09:12:03Z",
        "completedAt": "2026-09-24T09:13:41Z"
      },
      {
        "clustrJobItemId": "item_yrcd4mbn8kbc683xerbdd284tj",
        "clustrPersonId": "per_z6yzrhwpx1rnk19d2bw8q0ex64",
        "id": "0c1f3a52-51f4-4b8e-9d5c-2f8b1e7a9d10",
        "itemType": "contact",
        "linkedinUrl": "https://www.linkedin.com/in/john-roe",
        "linkedinId": "john-roe",
        "status": "FAILED",
        "reasonCode": "temporary",
        "reason": "Temporary error, retry",
        "errorMessage": "fetch profile: profile fetch: apify status 502: Bad Gateway",
        "retryCount": 0,
        "retryable": true,
        "createdAt": "2026-09-24T09:12:03Z",
        "completedAt": "2026-09-24T09:14:02Z"
      }
    ]
  }
}

{
  "success": false,
  "error": { "message": "job not found", "code": "NOT_FOUND" }
}

Authorizations

Authorization

string

header

required

The API key you created on the API settings page of the Clustr app.

Path Parameters

string

required

The job's Clustr ID (job_…), from List Jobs or the import that started it. The id from earlier responses also works.

Query Parameters

status

enum<string>

default:failed

failed (the default) lists the items that failed, completed the ones imported, and all every item.

Available options:

failed,

completed,

all

itemType

string

contact (a URL you sent), employee (a person an account-research run searched) or prospect (a person discovered through a contact). Send a comma-separated list for several.

limit

integer

default:100

Items per page, up to 500.

Required range: x <= 500

offset

integer

default:0

The number of items to skip, to read the next page.

Response

One page of items

success

boolean

required

data

object

required

Show child attributes

curl "https://api.clustr-ai.com/api/public/jobs/job_jctzmfh41nr4v8hvs87eakgs48/items?status=failed" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.clustr-ai.com/api/public/jobs/job_jctzmfh41nr4v8hvs87eakgs48/items",
    params={"status": "failed"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
for item in resp.json()["data"]["items"]:
    print(item["linkedinUrl"], item["reason"])

const resp = await fetch(
  "https://api.clustr-ai.com/api/public/jobs/job_jctzmfh41nr4v8hvs87eakgs48/items?status=failed",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } },
);
const { data } = await resp.json();

{
  "success": true,
  "data": {
    "clustrJobId": "job_jctzmfh41nr4v8hvs87eakgs48",
    "jobId": "job_abc123",
    "jobStatus": "COMPLETED",
    "status": "failed",
    "itemTypes": ["contact", "employee"],
    "total": 2,
    "limit": 100,
    "offset": 0,
    "items": [
      {
        "clustrJobItemId": "item_2ymmsvynzec1qpwz7qtt6qv6dx",
        "clustrPersonId": "per_dn4x39qnxzxjhp7f5p4npnhb8z",
        "id": "eb8abb1e-a6de-4a7f-8ba4-5e7154370978",
        "itemType": "contact",
        "linkedinUrl": "https://www.linkedin.com/in/jane-doe-123",
        "linkedinId": "jane-doe-123",
        "status": "FAILED",
        "reasonCode": "profile_not_found",
        "reason": "Profile not found or removed",
        "errorMessage": "fetch profile: apify returned no profile for https://www.linkedin.com/in/jane-doe-123",
        "retryCount": 0,
        "retryable": true,
        "createdAt": "2026-09-24T09:12:03Z",
        "completedAt": "2026-09-24T09:13:41Z"
      },
      {
        "clustrJobItemId": "item_yrcd4mbn8kbc683xerbdd284tj",
        "clustrPersonId": "per_z6yzrhwpx1rnk19d2bw8q0ex64",
        "id": "0c1f3a52-51f4-4b8e-9d5c-2f8b1e7a9d10",
        "itemType": "contact",
        "linkedinUrl": "https://www.linkedin.com/in/john-roe",
        "linkedinId": "john-roe",
        "status": "FAILED",
        "reasonCode": "temporary",
        "reason": "Temporary error, retry",
        "errorMessage": "fetch profile: profile fetch: apify status 502: Bad Gateway",
        "retryCount": 0,
        "retryable": true,
        "createdAt": "2026-09-24T09:12:03Z",
        "completedAt": "2026-09-24T09:14:02Z"
      }
    ]
  }
}

{
  "success": false,
  "error": { "message": "job not found", "code": "NOT_FOUND" }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Notes

Record Activity

Tags

Target Accounts

Client Companies

Excluded Companies

Buyer Titles

ICP

Competitor Monitoring

Connector Refresh

Notifications

List Failed Import Items

Reasons

Authorizations

Path Parameters

Query Parameters

Response

​Reasons

Authorizations

Path Parameters

Query Parameters

Response

Reasons