---
title: "Batch retrieve KOL records by IDs with user account data"
method: POST
path: "/api/v1/koc/batch-kols"
tags: ["KOC", "Batch Operations"]
---

# Batch retrieve KOL records by IDs with user account data

`POST /api/v1/koc/batch-kols`

## Request

- Base URL: `https://api.kolect.com`
- URL: `https://api.kolect.com/api/v1/koc/batch-kols`
- Auth: HTTP bearer

Retrieves KOL records in batches and checks for associated user accounts. If a user account exists, username and email from the users table will override the kols table data.

## Request body

- object
  - `kol_ids` string[], required: Array of KOL IDs to retrieve
  - `batch_size` integer: Number of records to process per batch (max 200)

## Response `200`

Successfully retrieved KOL records

- object
  - `success` boolean
  - `data` object[]
    - `has_user_account` boolean: Indicates if this KOL has an associated user account
    - `username` string: Username from users table if account exists, otherwise from kols table
    - `email` string: Email from users table if account exists, otherwise from kols table
  - `total_requested` integer: Total number of KOL IDs requested
  - `total_found` integer: Total number of KOL records found
  - `total_batches` integer: Number of batches processed
  - `not_found_ids` string[]: Array of KOL IDs that were not found
  - `processing_time_ms` integer: Total processing time in milliseconds

## Other responses

- `400`: Invalid request parameters
- `500`: Internal server error

---

[API](https://skmtc.dev/kolect/apis/kolect-api.md) · [All operations](https://skmtc.dev/kolect/apis/kolect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolect/apis/kolect-api/revisions/fe54528e8f54?raw)