> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kakiyo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prospect Import Status

> Returns asynchronous prospect import status, counts, and completed report rows

## 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

| Field    | Type     | Required | Description                                    |
| -------- | -------- | -------- | ---------------------------------------------- |
| `listId` | `string` | Yes      | Import list ID returned by the create endpoint |

## Example

```bash theme={null}
curl "https://api.kakiyo.com/v1/prospects/imports/import_list_id" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response

```json theme={null}
{
  "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:

```json theme={null}
{
  "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.


## OpenAPI

````yaml GET /prospects/imports/{listId}
openapi: 3.1.0
info:
  title: Kakiyo API
  description: API for automating LinkedIn outreach campaigns with AI-powered conversations
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.kakiyo.com/v1
security:
  - bearerAuth: []
paths:
  /prospects/imports/{listId}:
    get:
      summary: Prospect Import Status
      description: >-
        Returns asynchronous prospect import status, counts, and completed
        report rows
      operationId: getProspectImportStatus
      parameters:
        - name: listId
          in: path
          description: Import list ID returned by the create endpoint
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Import status returned successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  listId:
                    type: string
                    example: import_list_id
                  campaignId:
                    type: string
                    example: campaign_12345abcde
                  status:
                    type: string
                    example: completed
                  total:
                    type: integer
                    example: 1
                  processed:
                    type: integer
                    example: 1
                  imported:
                    type: integer
                    example: 1
                  existing:
                    type: integer
                    example: 0
                  invalid:
                    type: integer
                    example: 0
                  report:
                    type: array
                    items:
                      type: object
                      properties:
                        index:
                          type: integer
                          example: 0
                        status:
                          type: string
                          example: imported
                        prospectId:
                          type: string
                          example: prospect_id
                        chatId:
                          type: string
                          example: chat_id
                        chatCreated:
                          type: boolean
                          example: true
                        customDataSaved:
                          type: boolean
                          example: true
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: You do not have access to this import
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Import not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          example: validation_error
        message:
          type: string
          example: The request parameters failed validation
        details:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
                example: name
              message:
                type: string
                example: The name field is required
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````