Skip to main content
GET
/
prospects
/
imports
/
{listId}
Prospect Import Status
curl --request GET \
  --url https://api.kakiyo.com/v1/prospects/imports/{listId} \
  --header 'Authorization: Bearer <token>'
{
  "listId": "import_list_id",
  "campaignId": "campaign_12345abcde",
  "status": "completed",
  "total": 1,
  "processed": 1,
  "imported": 1,
  "existing": 0,
  "invalid": 0,
  "report": [
    {
      "index": 0,
      "status": "imported",
      "prospectId": "prospect_id",
      "chatId": "chat_id",
      "chatCreated": true,
      "customDataSaved": true
    }
  ]
}

Overview

Check the status of an asynchronous prospect import started by POST /prospects, POST /prospects/batch, or POST /prospects/batch/round-robin. Use this endpoint to confirm that Kakiyo created a chat before marking a lead as dispatched or imported in your own system.

Path parameters

FieldTypeRequiredDescription
listIdstringYesImport list ID returned by the create endpoint

Example

curl "https://api.kakiyo.com/v1/prospects/imports/import_list_id" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "listId": "import_list_id",
  "campaignId": "campaign_12345abcde",
  "status": "completed",
  "total": 1,
  "processed": 1,
  "imported": 1,
  "existing": 0,
  "invalid": 0,
  "skippedDnc": 0,
  "enrichmentFailed": 0,
  "currentIndex": 1,
  "startedAt": "2026-06-20T00:00:00.000Z",
  "lastProcessedAt": "2026-06-20T00:00:10.000Z",
  "completedAt": "2026-06-20T00:00:10.000Z",
  "report": [
    {
      "index": 0,
      "inputUrl": "https://linkedin.com/in/johnsmith",
      "linkedinSlug": "johnsmith",
      "status": "imported",
      "prospectId": "prospect_id",
      "chatId": "chat_id",
      "message": "Prospect imported and enriched",
      "chatCreated": true,
      "customDataSaved": true
    }
  ]
}

Confirmation rule

Treat a row as confirmed only when:
{
  "chatCreated": true
}
If chatCreated is false, Kakiyo did not create a new chat for that row, so no new customData was saved on a conversation.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

listId
string
required

Import list ID returned by the create endpoint

Response

Import status returned successfully

listId
string
Example:

"import_list_id"

campaignId
string
Example:

"campaign_12345abcde"

status
string
Example:

"completed"

total
integer
Example:

1

processed
integer
Example:

1

imported
integer
Example:

1

existing
integer
Example:

0

invalid
integer
Example:

0

report
object[]
Last modified on June 20, 2026